buildr-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Assaf Arkin <ar...@intalio.com>
Subject Re: Update to site and documentation
Date Wed, 18 Mar 2009 16:14:59 GMT
On Wed, Mar 18, 2009 at 5:52 AM, Alex Boisvert <boisvert@intalio.com> wrote:

> On Mon, Mar 16, 2009 at 3:57 PM, Assaf Arkin <arkin@intalio.com> wrote:
>
> > Last week I switched our documentation system to use Jekyll[1]. Before
> the
> > switch we used Docter to generate the Web site from Textile documents and
> > HAML templates. Jekyll replaces that with Textile documents and Liquid
> > templates.
>
>
> Nice work!  I'm happy to use a documentation system that has more traction
> while retaining the character of Docter.
>
> While on the subject of documentation, the Web site (and PDF) have two
> > sections called Recipes and Troubleshooting. The Wiki has two sections
> > called "Buildr How Tos" and "Common Problems and Solutions". I'd like to
> > consolidate both.
>
>
> My preference would be to keep them separate (recipes vs troubleshooting)
> since I think they are used under different situations.


That question didn't come out right.

We have Recipes and Buildr How Tos. I'd like to consolidate these.

We have Troubleshooting and Common Problems and Solutions. I'd like to
consolidate these.

That means out of the site/PDF and onto the Wiki.

Assaf


>
>
> The Wiki is much easier to edit than the Web site, so my preference right
> > now is to consolidate these duplicates and move them over to the Wiki,
> with
> > a link from the Web site navigation. Where it says Recipes right now it
> > will
> > say HowTo and link to the Wiki instead of another page on the site.
>
>
> Agreed.
>
> alex
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message