[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 23:13:11 -0400

On Thu, Sep 12, 2019 at 10:45 PM Branko Čibej <brane_at_apache.org> wrote:

> 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

That's the easy part. I have a virtual machine with a LAMP stack. :-)

Once there's actually something to show we can cross the bridge of either
asking Infra (nicely of course) or moving it to a subdirectory of staging,
with a link to coming soon, preview the new site. But let's not get ahead
of ourselves.
Received on 2019-09-13 05:13:38 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.