[task #15823] Generating About webpages from README-hacking.md

[Mohammad Akhlaghi]

Follow-up Comment #3, task #15823 (project reproduce):

Thanks a lot Pedram for the nice review of the markdown converters, its a
great resource to have. 

I was thinking about the same thing: a simple script can be written to break
up the 'README-hacking.md' into each sections, then feed them into the
converter to create separate HTML pages.

But generally, Markdown is a not a good documentation format and has always
annoyed me. I started 'README-hacking.md' in Markdown because of historical
reasons (it was initially part of 'README.md', then it grew large and I just
copied it to another file, and it grew! But I have been planning on adding a
proper documentation for Maneage in Texinfo for a long time, there were just
more important things to focus on.

With Texinfo we'll be able to automatically generate webpages, an elegant PDF,
and info pages that Maneage users can directly access on the command-line
within their own projects (for example with '.local/bin/info maneage'). 

The raw source of the Texinfo can be in the core Maneage branch, and its PDF
and info formats can built during './project configure'. For us developers, we
can build its HTMLs and put them in the webpage.

What do you think? If you agree, we can change the title of this task into
starting a Texinfo manual and not spend time and energy on the different
markdown converters.

    _______________________________________________________

Reply to this item at:

  <https://savannah.nongnu.org/task/?15823>

_______________________________________________
  Message sent via Savannah
  https://savannah.nongnu.org/