Jacques Le Roux <[email protected]> writes: > Le 08/11/2018 à 23:26, Mathieu Lirzin a écrit : >> Even if IME a majority of links are already broken in the Wiki (which is >> part of the reason why I am strongly convinced that Wikis as a main >> documentation are a bad idea), I would suggest replacing the page >> content with a link to the web version of the user/developper manual >> instead of simply deleting the page. This helps people keeping >> bookmarks on some important Wiki pages which could be hard to retrieve >> otherwise. Additionally this would help avoiding both internal and >> external links breakage. >> >> WDYT? >> > > Good idea, that would be links (one by release + trunk), or maybe only trunk > with an explanation on how to get to releases (just changing the URL).
It depends on how the Web documentation is organized but if we were to have a page referencing all released version of the documentation like JBake [1] we could point to it. > Also with an advice to use a browser addon you can see the file magnified > (not plain text) Shouldn't the documentation be available on the Web directly in HTML form with the output of AsciiDoctor? I am not sure to understand what you mean. As a side note: Do you know why the OFBiz website is still referencing the Confluence Wiki as the Developper/User manuals? Thanks. [1] https://jbake.org/docs/ -- Mathieu Lirzin GPG: F2A3 8D7E EB2B 6640 5761 070D 0ADE E100 9460 4D37
