Re: Big web page

[Phil Holmes]

----- Original Message ----- 
From: "Graham Percival" <address@hidden>
To: "Phil Holmes" <address@hidden>
Cc: "Devel" <address@hidden>
Sent: Friday, September 23, 2011 7:54 PM
Subject: Re: Big web page


> On Fri, Sep 23, 2011 at 05:03:21PM +0100, Phil Holmes wrote:
> > You know, I'm wondering if this serves any purpose.  It's a
> > humungous thing that takes an age to load and display, and for a
> > long time has had a load of missing images, bad links, etc.  No-one
> > complained much and no-one really seemed to notice.  Yet we lose the
> > images on web-examples and get a user report same day.
> >
> > Given the shenanigans needed to create it, might it make sense to retire 
> > it?
>
> When the new website was first being built, there was a huge
> outcry when I suggested not bothering with it.
>
> I'd rather keep it around, at least for a bit longer, because it
> serves as a canary.  Is the doc build system as generic as we
> need?  no.  (note that there's a few pictures in other manuals;
> it's not just web-big-html that needs them)   Is the doc build
> system as well-organized as we need?  of course not.
>
>
> I think we can do a huge amount of work just by cleaning up the
> "make website" process.  Admittedly that doesn't include
> web-big-html, but the increased understanding and simplifications
> should have follow-on effects to "make doc".
>
> Cheers,
> - Graham

I thought I'd start with a rather easier to follow description of how make 
website works.  It's attached as a text file with no formatting as yet, for 
quick thoughts.  If wanted I could put it on Rietveld as is, or if it's 
close enough to being useful, I could texify it first.

--
Phil Holmes

MakeWebsiteStory.txt
Description: Text document