[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: Nathan Hartman <hartman.nathan_at_gmail.com>
Date: Thu, 12 Sep 2019 22:18:19 -0400

On Thu, Sep 12, 2019 at 3:12 AM Branko Čibej <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.

Thoughts?
Received on 2019-09-13 04:18:47 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.