[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Simplifying our documentation

From: Branko Čibej <brane_at_apache.org>
Date: Fri, 13 Sep 2019 04:45:20 +0200

On 13.09.2019 04:18, Nathan Hartman wrote:
> On Thu, Sep 12, 2019 at 3:12 AM Branko Čibej <brane_at_apache.org
> <mailto:brane_at_apache.org>> wrote:
>
> On 12.09.2019 05:00, Nathan Hartman wrote:
> > I've been studying the site and there is a site-ng branch created
> > 2015. I remember a discussion about it around that time but I can't
> > find it in the archives now.
> >
> > Since there are no commits on site-ng beyond branch creation /
> readme,
> > would it be agreeable if I catch it up to the present and use it?
>
> site-ng was a misguided attempt at changing how our site
> implementation
> works (from server-side includes to generated static pages). If we
> ever
> do that overhaul, we'll probably use the new templating automation
> that
> Infra is working on.
>
> I'd prefer to *delete* the site-ng branch. The staging branch is there
> for preparing content changes.
>
> -- Brane
>
>
> I know about staging and it's convenient that it's served. But I'd
> like to experiment without worrying about breaking things. I hope to
> achieve three things:
>
> * Reorganize the information so visitors find what they want with
> minimal reading and searching
>
> * A more modern look
>
> * Improve display on mobile phones 
>
> I'd like to emphasize that I am *not* thinking about changing the
> implementation (SSI vs something else) at this time. Nor am I thinking
> about removing or rewriting the text. The information we have on the
> site is good and thorough. I just want to reorganize it and make a
> good first impression on visitors with an attractive home page -- and
> make sure we're all happy with it before it moves to staging.

Oh, then sure, either use site-ng or create another branch, whatever
suits you best. The only (minor) issue is that you'll have to cook up a
local server for testing. Or of course we could ask Infra nicely to
publish yet another branch of our site.

-- Brane
Received on 2019-09-13 04:45:23 CEST

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.