[FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions

[mick at flossmanuals.net]

Hi there,

For the FLOSS Manual Manual update, It would be great to get people's
experiences of when a platform like BookType that FM uses is the best
option for an individual to use for documentation, and when other tools
are a better fit.

Times have changed and when Adam Hyde FM started there was really
nothing out there like it in terms of flexibility and ease of use for
documentation. Now there are quite a few alternatives.

* https://readthedocs.org/ (in combination with https://www.sphinx-doc.org/_
* git books - and git pages - https://www.gitbook.com/
* some kind of static site generator using Jamstack / Hugo / Jekyll or
similar using mark-up source files
* other solutions

I'd be interested to know if people on this list who used to use FLOSS
Manuals but now use something else would like to comment on the pros and
cos. The purpose is to write a chapter that helps people evaluate if FM
is the right place for them. Some of the factors might be...

* ease of use, pros and cos of using WYSIWYG
* limits to version control
* translations
* issues around communities and particular needs / expectations

One thing, it would be great not to focus on past / current issues of
using BookType. If you have bug reports or feature requests it would be
great to put them here instead.
https://gitlab.com/flossmanuals/fm_booktype

But even if there's an overlap, then please chip in!

nice one!

Mick