Merhaba:

We currently generate documentation from 'git cloned' source code for the 
following
- gcc
- gcc libstdc++
- emacs
- python

My proposal is to place the generated HTML docs at a definitive directory on 
the SoftwareFreedomProject.org website

sub_domain
https://doc.SoftwareFreedomProject.org/

sub_dir
https://SoftwareFreedomProject.org/doc/

BENEFIT
- single point of reference
- URL's valid and work over the long-term
- API docs generated at a much greater level of detail
- UML diagrams with customization

Please see the visual examples below.

ILLUSTRATION

std::filesystem

  upstream project
  https://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01719.html

  what we generate
  https://softwarefreedom.sourceforge.io/libstdcxx/api/a01871.html

std::filesystem::filesystem_error

  upstream project
  https://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a04790.html

  what we generate
  https://softwarefreedom.sourceforge.io/libstdcxx/api/a04908.html


With this perspective, please suggest the choice to make, 'sub_domain' or 
'sub_dir'.


warm regards
Saifi.

Reply via email to