On Tue, 29 Apr 2025 at 16:35, Niall Pemberton <niall.pember...@gmail.com> wrote:
>
> 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.

The other output is cwiki_retired; should keep a copy of that too (or
at least tag it).

> 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