On Tue, 29 Apr 2025 at 15:42, sebb <seb...@gmail.com> wrote:

> On Tue, 29 Apr 2025 at 12:27, Niall Pemberton <niall.pember...@gmail.com>
> wrote:
> >
> > On Tue, 29 Apr 2025 at 09:32, sebb <seb...@gmail.com> wrote:
> >
> > > I think it is a good replacement for the current site, and seems to
> > > have all the existing features.
> > > Builds are quick and work well (but will need adjustment for the live
> site)
> > >
> > > There is a fix I think is needed:
> > > The list of retired projects will only get longer.
> > >
> > > At present when the LH drop-down is opened, the Event logo does not
> > > have enough room.
> > >
> >
> > We can look at moving it after the sites live.
> >
> >
> > > It's also quite awkward having to scroll down the list.
> > >
> > > I think it might be better to have a multi-column table of project
> > > names, as is done here:
> > > https://www.apache.org/#apache-project-list
> > >
> >
> > IMO its best to use the tools in the way that they're designed. With the
> > "JustTheDocs" theme you just have to set a "title" and (optionally) a
> > "parent" attribute and the Sidebar navigation just works. So for me, I
> > think we should keep it.
> >
> > Additionally, we also now have "Site Search", and a "Retired Projects"
> page
> > which people can also use to navigate to projects - as well as the menu
> on
> > the left.
> >
> > I think we should go live with what we have at the moment and discuss
> this
> > after. One possible option:
> >
> > I just added a "project_type" attribute, so we can now distinguish
> between
> > PMCs and Subprojects - one option would be to have PMCs/Subprojects under
> > separate menus and pages
> >
> >
> > > Sebb
> > > P.S I hope to have the replacement for retired.py ready soon; it's
> > > mostly working.
> > >
> >
> > For now we can copy the project YAML template, fill in the details and
> > committing it directly - so don't think we need to wait for this to go
> > live,
>
> It's not filling in the details that is the hard bit - it's finding
> the values to use.
>
> I thought the point of a replacement was not to lose any functionality.
>

This was never discussed - as a generalization I would agree, but I think
the functionality we gain would far offset any loss.


> Can you not wait a day or two more?
>

Why? We don't have any projects that currently need to be setup. The next
board meeting is 3 weeks away AND its not time critical anyway. Its not
required for the Website to be fully functional - so no need to delay for
it.

My plan is to create a PR today for the new website and hopefully get
agreement to put it live asap.


> Also, I think the existing site needs to be kept available online for
> comparison for a while after any replacement is performed.
> The existing site could be copied to a staging/preview site.
>

Good idea - just copy the generated asf-site branch to a new name &
configure it as staging.

Niall


> > Niall
> >
> >
> > > On Tue, 29 Apr 2025 at 07:20, Herve Boutemy <hbout...@apache.org>
> wrote:
> > > >
> > > > ah ok, I completely misunderstood that it was more a fork of
> > > attic-jekyll-site than a Git repo just for a theme :)
> > > >
> > > > I love this site layout, with Attic color scheme: I think it is ready
> > > for preparing a PR to our ASF attic Git repo
> > > >
> > > > thanks everybody for the great work
> > > >
> > > > Hervé
> > > >
> > > > On 2025/04/28 20:53:58 Niall Pemberton wrote:
> > > > > On Mon, 28 Apr 2025 at 20:24, Herve Boutemy <hbout...@apache.org>
> > > wrote:
> > > > >
> > > > > > do we really need a separate Git repo just for that?
> > > > > > I suppose you just configured the JustTheDocs, not really
> modified
> > > it,
> > > > > > isn't it?
> > > > > >
> > > > >
> > > > > I created the repo from the JustForDocs template - just to have a
> look
> > > &
> > > > > play with it. After that, I thought I would just the site I'd
> built in
> > > the
> > > > > other repo to see how it worked (if it didn't work well or look
> good I
> > > > > could then just discard it). Anyway, so yes, didn't need a separate
> > > repo -
> > > > > but thats just how it ended up
> > > > >
> > > > > Niall
> > > > >
> > > > >
> > > > >
> > > > >
> > > > > >
> > > > > > Regards,
> > > > > >
> > > > > > Hervé
> > > > > >
> > > > > > On 2025/04/28 02:40:00 Niall Pemberton wrote:
> > > > > > > I've fixed a number of things:
> > > > > > >
> > > > > > >
> > > > > >
> > >
> https://github.com/niallkp/attic-justthedocs/commit/58326153cdae4ab5c091dba021cdfe4a90009a6b
> > > > > > >
> > > > > > > Niall
> > > > > > >
> > > > > > > On Sun, 27 Apr 2025 at 14:34, Niall Pemberton <
> > > niall.pember...@gmail.com
> > > > > > >
> > > > > > > wrote:
> > > > > > >
> > > > > > > > Theres still some stuff todo with this website, but its
> mostly
> > > minor.
> > > > > > The
> > > > > > > > main question is whether overall this is an acceptable
> > > replacement for
> > > > > > the
> > > > > > > > current Attic website - both from a "Look & Feel" perspective
> > > and the
> > > > > > > > overall mechanism for retiring projects (i.e. using YAML
> files
> > > for
> > > > > > retired
> > > > > > > > project data to drive the website generation)?
> > > > > > > >
> > > > > > > > NIall
> > > > > > > >
> > > > > > > > On Sun, 27 Apr 2025 at 11:53, Niall Pemberton <
> > > > > > niall.pember...@gmail.com>
> > > > > > > > wrote:
> > > > > > > >
> > > > > > > >> I've had a play with using the JustTheDocs Jekyll Theme[1]
> with
> > > the
> > > > > > new
> > > > > > > >> website[2] - you can take a look at it here (still a work in
> > > > > > progress):
> > > > > > > >>
> > > > > > > >>     https://niallkp.github.io/attic-justthedocs/
> > > > > > > >>
> > > > > > > >> One of the nice things is that it comes with search, I like
> the
> > > menu
> > > > > > down
> > > > > > > >> the LHS and it has a mechanism to have a copy button on our
> > > template
> > > > > > text
> > > > > > > >> (see resolution page, other pages are TODO)
> > > > > > > >>
> > > > > > > >> Niall
> > > > > > > >>
> > > > > > > >> [1] https://just-the-docs.github.io/just-the-docs/
> > > > > > > >> [2] https://github.com/niallkp/attic-justthedocs
> > > > > > > >>
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > >
>

Reply via email to