Re: Re: Netbeans documentation site question
On Tue, 26 Jul 2022 at 13:20, Eric Bresie wrote: > > Built content is then pushed to > https://github.com/apache/netbeans-website/tree/asf-site > > > Is that the branch with the original donation? > > Seems like it’s a branch that is ”929 commits ahead, 1567 commits behind > master.” No. It's the "built content" - ie. the files that are actually served by the website server. https://cwiki.apache.org/confluence/display/INFRA/git+-+.asf.yaml+features#Git.asf.yamlfeatures-WebsitedeploymentserviceforGitrepositories Neil - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
RE: Re: Netbeans documentation site question
Hi Not it's the actual website. We bake the master to this asf-site branch and that is what is published Eric -Message d'origine- De : Eric Bresie <> Envoyé : mardi 26 juillet 2022 14:20 À : Neil C Smith Cc : dev@netbeans.apache.org Objet : Re: Re: Netbeans documentation site question > Built content is then pushed to > https://github.com/apache/netbeans-website/tree/asf-site Is that the branch with the original donation? Seems like it’s a branch that is ”929 commits ahead (https://github.com/apache/netbeans-website/compare/master...asf-site), 1567 commits behind (https://github.com/apache/netbeans-website/compare/asf-site...master) master.” Eric Bresie ebre...@gmail.com (mailto:ebre...@gmail.com) > On July 15, 2022 at 6:07:31 AM CDT, Neil C Smith (mailto:neilcsm...@apache.org)> wrote: > On Thu, 14 Jul 2022 at 15:00, Michael Bien (mailto:mbie...@gmail.com)> wrote: > > > > On 14.07.22 15:51, Jean-Marc Borer wrote: > > > > > > Is there a possibility to preview the changed asciidoctor page > > > without saving (committing) it? > > > > you commit to your clone of the website. Then you can create a PR to > > the actual website. You can preview the markup on github which looks > > similar. Don't know if there is a way to preview it in its final form. > > Sure. You'll need JDK 8 or 11. > > cd netbeans.apache.org (http://netbeans.apache.org) ./gradlew clean > buildSite ./gradlew run > > Open localhost:8080 in browser. > > If a change doesn't show up, usually just SASS, try ./gradlew clean > buildSite --rerun-tasks > > > > When is the site regenerated with the latest content on github and > > > which branch is used for that? > > > > don't know how often it happens (last time I edited something it > > happened right away). I suppose its master. > > Regenerated on commits to master and built by > https://ci-builds.apache.org/job/Netbeans/job/netbeans-website/ > > Best wishes, > > Neil > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > (mailto:dev-unsubscr...@netbeans.apache.org) > For additional commands, e-mail: dev-h...@netbeans.apache.org > (mailto:dev-h...@netbeans.apache.org) > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Re: Netbeans documentation site question
> Built content is then pushed to > https://github.com/apache/netbeans-website/tree/asf-site Is that the branch with the original donation? Seems like it’s a branch that is ”929 commits ahead (https://github.com/apache/netbeans-website/compare/master...asf-site), 1567 commits behind (https://github.com/apache/netbeans-website/compare/asf-site...master) master.” Eric Bresie ebre...@gmail.com (mailto:ebre...@gmail.com) > On July 15, 2022 at 6:07:31 AM CDT, Neil C Smith (mailto:neilcsm...@apache.org)> wrote: > On Thu, 14 Jul 2022 at 15:00, Michael Bien (mailto:mbie...@gmail.com)> wrote: > > > > On 14.07.22 15:51, Jean-Marc Borer wrote: > > > > > > Is there a possibility to preview the changed asciidoctor page without > > > saving (committing) it? > > > > you commit to your clone of the website. Then you can create a PR to the > > actual website. You can preview the markup on github which looks > > similar. Don't know if there is a way to preview it in its final form. > > Sure. You'll need JDK 8 or 11. > > cd netbeans.apache.org (http://netbeans.apache.org) > ./gradlew clean buildSite > ./gradlew run > > Open localhost:8080 in browser. > > If a change doesn't show up, usually just SASS, try ./gradlew clean > buildSite --rerun-tasks > > > > When is the site regenerated with the latest content on github and > > > which branch is used for that? > > > > don't know how often it happens (last time I edited something it > > happened right away). I suppose its master. > > Regenerated on commits to master and built by > https://ci-builds.apache.org/job/Netbeans/job/netbeans-website/ > > Best wishes, > > Neil > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > (mailto:dev-unsubscr...@netbeans.apache.org) > For additional commands, e-mail: dev-h...@netbeans.apache.org > (mailto:dev-h...@netbeans.apache.org) > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > >
Re: Netbeans documentation site question
On Thu, 14 Jul 2022 at 15:00, Michael Bien wrote: > > On 14.07.22 15:51, Jean-Marc Borer wrote: > > > > Is there a possibility to preview the changed asciidoctor page without > > saving (committing) it? > > you commit to your clone of the website. Then you can create a PR to the > actual website. You can preview the markup on github which looks > similar. Don't know if there is a way to preview it in its final form. Sure. You'll need JDK 8 or 11. cd netbeans.apache.org ./gradlew clean buildSite ./gradlew run Open localhost:8080 in browser. If a change doesn't show up, usually just SASS, try ./gradlew clean buildSite --rerun-tasks > > When is the site regenerated with the latest content on github and > > which branch is used for that? > > don't know how often it happens (last time I edited something it > happened right away). I suppose its master. Regenerated on commits to master and built by https://ci-builds.apache.org/job/Netbeans/job/netbeans-website/ Built content is then pushed to https://github.com/apache/netbeans-website/tree/asf-site Best wishes, Neil - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Netbeans documentation site question
On 2022/07/14 15:51, Jean-Marc Borer wrote: Is there a possibility to preview the changed asciidoctor page without saving (committing) it? You can install Antora on your dev machine and use it to generate the HTML site locally. There's a docker image for it (antora/antora:3.0.2) which makes life a little easier. -- Mike Morris https://www.mikro2nd.net/about-email - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Netbeans documentation site question
On 14.07.22 15:51, Jean-Marc Borer wrote: Is there a possibility to preview the changed asciidoctor page without saving (committing) it? you commit to your clone of the website. Then you can create a PR to the actual website. You can preview the markup on github which looks similar. Don't know if there is a way to preview it in its final form. When is the site regenerated with the latest content on github and which branch is used for that? don't know how often it happens (last time I edited something it happened right away). I suppose its master. -mbien Cheers, JM On Thu, Jul 14, 2022 at 1:42 PM Jean-Marc Borer wrote: Hi there, I started reviewing some asciidoctor pages of the netbeans apache site. I read the instructions on https://netbeans.apache.org/kb/docs/contributing.html to understand how to proceed. However, it doesn't tell what to do when the review is finished: shall we remove the footer that say it was automatically imported and what about the header that reads "Note: these pages are being reviewed" image.png Cheers, JM
Re: Netbeans documentation site question
On 14.07.22 15:42, Jean-Marc Borer wrote: Hi there, I started reviewing some asciidoctor pages of the netbeans apache site. I read the instructions on https://netbeans.apache.org/kb/docs/contributing.html to understand how to proceed. However, it doesn't tell what to do when the review is finished: shall we remove the footer that say it was automatically imported and what about the header that reads "Note: these pages are being reviewed" image.png Cheers, JM if the page is made up2date, we should remove the "page needs review" box on that page, the "automatically imported" note probably also doesn't serve any purpose anymore once its updated. Also make sure that you update the metadata, it has a "reviewed" field with a date. best regards, michael
Re: Netbeans documentation site question
Once I get all the required instructions, I will update the contributing page accordingly. I the meantime I guess that: 1) one shall add :reviewed: -mm-dd metadata tag 2) remove the footer text: "*NOTE:* This document was automatically converted... " 3) remove the needsreview tag Correct? Am I missing someting? Is there a possibility to preview the changed asciidoctor page without saving (committing) it? When is the site regenerated with the latest content on github and which branch is used for that? Cheers, JM On Thu, Jul 14, 2022 at 1:42 PM Jean-Marc Borer wrote: > Hi there, > > I started reviewing some asciidoctor pages of the netbeans apache site. I > read the instructions on > https://netbeans.apache.org/kb/docs/contributing.html to understand how > to proceed. > > However, it doesn't tell what to do when the review is finished: shall we > remove the footer that say it was automatically imported and what about the > header that reads "Note: these pages are being reviewed" > > [image: image.png] > > Cheers, > > JM >
Netbeans documentation site question
Hi there, I started reviewing some asciidoctor pages of the netbeans apache site. I read the instructions on https://netbeans.apache.org/kb/docs/contributing.html to understand how to proceed. However, it doesn't tell what to do when the review is finished: shall we remove the footer that say it was automatically imported and what about the header that reads "Note: these pages are being reviewed" [image: image.png] Cheers, JM
