From: | Steven Schlansker <stevenschlansker(at)gmail(dot)com> |
---|---|
To: | Dave Cramer <pg(at)fastcrypt(dot)com> |
Cc: | Stephen Nelson <stephen(at)eccostudio(dot)com>, dmp <danap(at)ttc-cmc(dot)net>, Heikki Linnakangas <hlinnakangas(at)vmware(dot)com>, PostgreSQL JDBC <pgsql-jdbc(at)postgresql(dot)org> |
Subject: | Re: Website Redo Kick Off |
Date: | 2013-07-10 23:29:28 |
Message-ID: | 2410B642-76DC-45C5-B1CB-F32CE5029622@gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-jdbc |
I like the workflow that Jekyll promotes. Documentation updates can be submitted in the same way as code updates (as pull requests) and the Markdown syntax is easy to learn / use. There is low perceived friction to updating the documentation, which is good to drive contributions.
I have only used it in the context of GitHub (i.e. I cannot vouch that maintaining it outside of the context is as easy as they claim, nor do I have any reason to believe it isn't) but I think it deserves a close look.
+1 on too many choices, unless there are volunteers to go through all of them we can probably just look at the five "most popular" or something.
On Jul 10, 2013, at 3:54 PM, Dave Cramer <pg(at)fastcrypt(dot)com> wrote:
> Dana,
>
> I think you gave us too many choices!
>
> If I had to choose it would be jekyll only because of the inertia from the github folks
>
>
> Dave Cramer
>
> dave.cramer(at)credativ(dot)ca
> http://www.credativ.ca
>
>
> On Wed, Jul 10, 2013 at 3:29 PM, Stephen Nelson <stephen(at)eccostudio(dot)com> wrote:
> Echoing what Heikki said, I personally haven't used any of the site generators mentioned. However the solution does need to be a simple git checkout and with minimal dependencies you can make updates. I've tried to get the current site doc generated a few times without much luck in generating some of the pages. So definitely simplicity rules.
>
> I believe github uses Jekyll and it supports the markdown syntax that is easy to understand and used on github. But I haven't used it so can't vouch for its ease of use or popularity.
>
> Cheers,
>
> Stephen
>
From | Date | Subject | |
---|---|---|---|
Next Message | dmp | 2013-07-11 00:58:13 | Re: Website Redo Kick Off |
Previous Message | Dave Cramer | 2013-07-10 22:54:54 | Re: Website Redo Kick Off |