Closed mwestphal closed 1 year ago
@Meakk : for the time being, lets keep update the ReadME.md, but lets not touch the old doc for the website.
Doc should be added for the libf3d too.
Here is a an updated plan for the new doc:
- README.md: contains generic presentation, link to release, quick how to use and acknoledgements
- GALLERY.md: same content as https://f3d-app.github.io/f3d/gallery/
- doc
-- OPTIONS.md: contains # Options
-- HOTKEYS.md: contains # Interaction and # Cycling coloring
-- INSTALATION.md: contains # Instalation
-- USAGE.md: contains # File Formats, # Scene construction, # rendering precedence, and anything else
-- CONFIGURATION_FILE.md: contains # Configuration File
-- DESKTOP_INTEGRATION.md: contains # Desktop Integration
-- LIMITATIONS.md: contains # Limitations
-- TROUBLESHOOTING.md: contains # Troubleshooting
-- dev
--- BUILD.md: contains # Build
--- GENERATE_COVERAGE.md: info about generating coverage
--- GENERATE_MAN.md: info about generating man
--- DEVELOP.md: info about our process of developement and how to contribute to f3d
-- libf3d
--- OVERVIEW.md: generic information about the libf3d, partially contains README_libf3d.md
--- EXAMPLES.md: expanded set of examples usage of the libf3d, insipired by README_libf3d.md
--- doxygen: not sure of the feasiability of this, but doxygen should be used to generate actual ref for libf3d
wdyt @Meakk @Audrey_il_te_faut_un_compte_github ?
Please provide some feedback @Meakk
We need a section for python/java bindings, otherwise looks good to me.
- README.md: contains generic presentation, link to release, quick how to use and acknoledgements
- GALLERY.md: same content as https://f3d-app.github.io/f3d/gallery/
- doc
-- OPTIONS.md: contains # Options
-- HOTKEYS.md: contains # Interaction and # Cycling coloring
-- INSTALATION.md: contains # Instalation
-- USAGE.md: contains # File Formats, # Scene construction, # rendering precedence, and anything else
-- CONFIGURATION_FILE.md: contains # Configuration File
-- DESKTOP_INTEGRATION.md: contains # Desktop Integration
-- LIMITATIONS.md: contains # Limitations
-- TROUBLESHOOTING.md: contains # Troubleshooting
-- dev
--- BUILD.md: contains # Build
--- GENERATE_COVERAGE.md: info about generating coverage
--- GENERATE_MAN.md: info about generating man
--- DEVELOP.md: info about our process of developement and how to contribute to f3d
-- libf3d
--- OVERVIEW.md: generic information about the libf3d, partially contains README_libf3d.md
--- EXAMPLES.md: expanded set of examples usage of the libf3d, insipired by README_libf3d.md
--- BINDINGS.md
--- doxygen: not sure of the feasiability of this, but doxygen should be used to generate actual ref for libf3d
Trying github upload
![Uploading logo.png…]()
Fixed by #364
Documentation is hard to maintain, here is the current state:
This should be improved, here is what we need to have:
Here is a proposition to fix that:
Example .md file organization, that could also be used as a webdoc organisation:
Differences between README.md and webdoc md files:
many nbsp in the webdoc (could be fixable?)
Options &|Description
Options|Description
Internals links are removed (should be fixable)
See the coloring cycle section for more info.
See the [coloring cycle](#Cycling Coloring) section for more info.
If all slight change are removed, simply symlinking from the webdoc to the doc.md could be a very easy solution to put into place.