Right, it's easy to write a simple wiki but a lot of work to write a
good one and maintain it, and no great markup language has emerged
yet. If you are the only editor, then you don't need wikis' multiple
authoring or simple markup language -- so the main question is how
*you* want to edit.

I'd suggest Sphinx for a users' guide. You write it in ReStructured
Text, convert it to static HTML, and host it on any webserver. It
supports previous/next links and a table of contents. Similar products
include Pelican and others.


On Fri, Sep 1, 2017 at 10:52 PM, Steve Piercy
<[email protected]> wrote:
> Wikis are crapware.  They're a headache to maintain.
>
> The Pylons Project contributors use GitHub repos and Read the Docs to
> produce user guides and other documentation.
>
> --steve
>
>
> On 9/1/17 at 8:01 PM, [email protected] (Sean Tan) pronounced:
>
>> Hi. I want to write a user guide for a client. I thought it is better to
>> host it online, so I don't have to periodically email an updated version to
>> my client. I wonder why Wiki engines do you Pyramid folks use? Any
>> suggestions?
>>
>
> ------------------------
> Steve Piercy, Soquel, CA
>
> --
> You received this message because you are subscribed to the Google Groups
> "pylons-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pylons-discuss/r473Ps-10126i-561A0A6A1F7845678C43C4D5A6F32211%40Steves-iMac.local.
>
> For more options, visit https://groups.google.com/d/optout.



-- 
Mike Orr <[email protected]>

-- 
You received this message because you are subscribed to the Google Groups 
"pylons-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/pylons-discuss/CAH9f%3DuqMmr_F_1h3ZyaTL83D6dAyB0fmwL4GE04yUkTb9mz7QQ%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to