[Dcoumentation] Define basic style for landing page

[pylapp]

Context

Today our technical documentation is exposed through GitHub Pages and available at ios.unified-design-system.orange.com.
The content of the gh-pages is composed by assets of doccarchive folders exported using Xcode.
These elements are then processed so as to extract the assets we want, forge the final "web site" and create the landing page (#168).
The current script making such operation is this one. It copies and pastes HTML, CSS and JS files, and also merges some JSON.

These assets, picked from doccarchives files are in fact generated through documentation catalogs and DocC comments: thus the doc we have in our code is then reflected in a web fashion.

We export as many doccarchives as modules defined in our Swift Package.

Today, no Apple tool using the DocC documentation framework is able to output an HTML page pointing to all of these modules. Thus we use this script to forge an HTML file.

More details about the documentation toolchain avaialble in this wiki page.

Issue

That page is ugly, but it does the job:

• it exposes hyperlinks pointing to all modules
• the library version is displayed so as to notify the user the version of the doumentation lib he / she is reading
• it refers also the GitHub project and the wiki
• it contains the build number of the documentation

But the page is ugly and not Orange branded.

Solution?

Use Boosted to customize the page to make it nicer, at least this the ODS web site
The script generating this main page must be keept as simple as possible. We can consider exracting the HTML code inside a side file, but we won't add more assets not framework.

The page can be found here

Attached: HTML page source

[pylapp]

Maybe @louismaximepiton or @julien-deramond know some tips or starter kits or the use of Boosted.

@hannahiss I may remember you have a quite similar need in your side.

[louismaximepiton]

Maybe we can wait for a common design landing page for web documentation and we will backport it in here once we have it. On the stack, if we want at least an header or footer, I'm afraid that we will need to have Boosted as a dependency for now. But let's wait for a design.

[hannahiss]

Yes I asked for a design for our homepage at least, but there has been 0 discussion about it so I'm not sure at all the need has been understood... Today Frederic assigned the issue to me in Jira 😦 ??!!
Issue is number 397 in our tracking tool
For the header/footer it will probably stay as is for now