Hi Tim/Frank,

 

We are aware of the issue and still working on making the documentation available again. We aim to get all the material back online. It might not happen at once: we are planning to make the first bits available soon and the rest will be added back gradually over time.

 

Thank you both for your interest in Mbed TLS and for your patience.

 

Kind regards,

Janos

 

 

From: Frank Bergmann via mbed-tls <mbed-tls@lists.trustedfirmware.org>
Date: Thursday, 7 July 2022 at 13:25
To: mbed-tls@lists.trustedfirmware.org <mbed-tls@lists.trustedfirmware.org>
Subject: [mbed-tls] Re: State of documentation

I fully agree! I'm also missing a lot of details.
The new pages are somewhat ridiculous.

On 07.07.22 14:17, Tim Becker via mbed-tls wrote:

Hi all,

 

it feels like the state of documentation has deteriorated since the last time I've used mbedtls (a couple of months ago). I'm not sure if the google index hasn't fully been updated yet, or I don't understand the new structure of the docs or ... 

 

Also, is this the proper forum to make suggestions? Should I raise an issue on Github?

 

1.) a lot of previously linked, useful information now redirects here: https://www.trustedfirmware.org/projects/mbed-tls/ which (please excuse my frankness) feels like an utterly useless abomination that only marketing people could love.

 

- Some examples of previously useful links: from the wiki (https://developer.trustedfirmware.org/w/mbed-tls/) :

 

> Old Mbed TLS website
> Documentation: Mbed TLS API Reference; Knowledge base; Dev corner

 

all redirect to trustedfirmware.org ! As do nearly all the links in https://github.com/Mbed-TLS/mbedtls/blob/development/SUPPORT.md

 

2.) there is no longer an doxygen generated API documentation anywhere only. I could generate it myself, but then I'd need to get and install Doxygen, figure how to use it, etc. It would be great if this were restored. It can't be that expensive to host :)

 

Anyway, it feels like I've been running around for hours trying to find _anything_ useful, but I just realized everything is redirected to trustedfirmware.org ... Is there any way to still access the old, useful docs?

 

Thanks & sorry that this post is so negative,

      -tim





-- 
Frank Bergmann, Pödinghauser Str. 5, D-32051 Herford, Tel. +49-5221-9249753
SAP Hybris & Linux LPIC-3, E-Mail tx2014@tuxad.de, USt-IdNr DE237314606
http://tdyn.de/freel  -- Redirect to profile at freelancermap
http://www.gulp.de/freiberufler/2HNKY2YHW.html  -- Profile at GULP