On Sun, 6 Mar 2022 at 14:43, Greg Stein <gst...@gmail.com> wrote:
>
> On Sun, Mar 6, 2022 at 4:52 AM sebb <seb...@gmail.com> wrote:
>
> > On Sun, 6 Mar 2022 at 10:30, Greg Stein <gst...@gmail.com> wrote:
> >
> >...
>
> > > Thus: my suggestion that the source content for the site lives on the
> > main
> > > branch (next to all our code) in the "site" subdir, and gets generated to
> > > the "asf-site" branch. Apache STeVe developers shouldn't ever have to
> > > change branches (stick to "main" for both dev and site work).
> >
> > OK, in which case I agree that it is not a disadvantage for the
> > average developer.
> >
> > AFAICT it makes the site build process more complicated, but that is
> > usually automated.
> >
>
> Hunh? It would be totally automated. Push a change to main:/site and then
> pelican produces a change and pushes to asf-site branch. Then it appears on
> the website.

I was thinking about needing to test a change locally, without committing.
Or needing to investigate a site build issue.

> This build is part of the .asf.yaml system. It's basically invisible. Just
> change the .md files and they appear a few seconds later on the website.
> Even better: on github.com, you can use the "pencil" to edit the .md files
> and then click the "Preview" tab before committing. The process uses the
> same markdown as GitHub's preview (minus the page CSS, of course). And I
> mean *the same* ... we use GitHub Inc's C library to perform the
> markdown->HTML translation. It makes editing .md files much like a wiki in
> ease-of-use.

Indeed, but there may still be the occasional need to try local builds.

> Cheers,
> -g

Reply via email to