Makes sense, perfect. Gj
On Sun, Jan 6, 2019 at 11:43 AM Antonio <anto...@vieiro.net> wrote: > Hi all, > > Let's set up a plan to gradually allow the users to navigate to > different tutorials. For instance, let's allow them to visit the "java" > tutorials but not the "C++" tutorials (not at least until we support C++). > > We will have to manually review many pages. For instance, this one: > > http://netbeans.apache.org/kb/docs/java/quickstart.html > > Has some minor problems with images and at the bottom of the page > there's some weird table that we may want to remove. > > For instance, in the coming weeks we want to review > > - Java tutorials. > - PHP tutorials. > > And then prepare for the Enterprise donation > - Java EE tutorials. > - Web services tutorials. > > And then for the C++ donation: > - C++ tutorials > > etc. > > Let's think of the order of the tutorials we want to review and let's > set up a master JIRA issue (Kanban board?) to track all the tutorial > donations, with subtasks/subissues for each section of the documentation. > > I'll try to do that in the coming days (as today I'm busy with the three > wise men [1]). > > Kind regards, > Antonio > > > [1] > https://en.wikipedia.org/wiki/Biblical_Magi#Spanish_customs > A tradition in Spain where "Los Reyes Magos" give presents to children, > quite similar to Santa in other parts of the world. > > > El 06/01/2019 a las 11:33, Geertjan Wielenga escribió: > > Excellent progress! > > > > I have squashed and merged. > > > > I believe this page https://netbeans.apache.org/help/index.html should > be > > seen as the future version of this page > https://netbeans.org/kb/index.html. > > > > Could we have 'kb' (i.e., knowledge base) in the URL where there > currently > > is 'help'? > > > > Gj > > > > > > On Sun, Jan 6, 2019 at 11:16 AM Antonio <anto...@vieiro.net> wrote: > > > >> Hi all, > >> > >> Please see https://github.com/apache/incubator-netbeans-website/pull/97 > >> with the netbeans.org tutorials/trails automatically transformed to > >> asciidoc. This is still a work in progress. > >> > >> Main features: > >> > >> - 3rd donation tutorials automatically converted to Asciidoc with > >> incubator-netbeans-tools > >> - This is, we removed netbeans.org specific HTML stuff. > >> - Copied images automatically in a 'images' subdir near the documents. > >> - Added syntax highlighting support for different languages (also wiki > >> pages). > >> - Files are stored in the same locations as in netbeans.org, to ease > >> migration (i.e., kb/docs/, kb/docs/java, etc.) > >> > >> Tutorials are _NOT_ linked from the home page, this is, there's no link > >> from the website to the tutorials as of yet: users won't be able to > >> navigate to the tutorials. > >> > >> When/if merged, we will have to navigate directly to a tutorial or to > >> http://netbeans.apache.org/kb or to http://netbeans.apache.org/kb/docs/ > >> > >> The idea is to decide which tutorials we're linking from the web. For > >> instance, we may not want to link to C/C++ tutorials yet (because we > >> don't support it yet), but we may want to link to PHP tutorials. > >> > >> So the basic plan is to: > >> > >> - Decide which subdirectories we'll link from the main web. > >> - Manual fine-tuning of content (missing images, removing of manual > >> table of contents, etc.). > >> > >> I'll be offline most of the day today, but will try to set up a plan in > >> the coming days as time permits. > >> > >> Kind regards, > >> Antonio > >> > >> > >> > >> > >> > >> > >> El 05/01/2019 a las 10:51, Geertjan Wielenga escribió: > >>> It seems they're in your GitHub, right now, i.e., github.com/vieiro: > >>> > >>> > >> > https://github.com/vieiro/incubator-netbeans-website/blob/feature/third-donation-tutorials/netbeans.apache.org/src/content/kb/docs/java/quickstart.asciidoc > >>> > >>> Is this correct, right now, or is there a link on the Apache NetBeans > >>> GitHubs somewhere. > >>> > >>> Thanks, > >>> > >>> Gj > >>> > >>> On Sun, Dec 30, 2018 at 11:20 PM Antonio <anto...@vieiro.net> wrote: > >>> > >>>> Good plan! Thanks, Geertjan! > >>>> > >>>> El 30/12/2018 a las 12:24, Geertjan Wielenga escribió: > >>>>> Great and thanks for all the work! > >>>>> > >>>>> From my point of view, it would be simplest if you'd create a > list of > >>>> tasks > >>>>> on the Wiki, each task being an issue so that we can track via JIRA. > >>>>> > >>>>> So far, it seems to me that the best approach is to simply take the > >> lead > >>>>> and put those tasks out there as a starting point, and then others > will > >>>>> take it from there. A discussion that is too open is not going to get > >> too > >>>>> many responses, it seems so far. > >>>>> > >>>>> From my end, I've been working on netbeans.org -- especially the > >> front > >>>> page > >>>>> where every link AFAIK now point to netbeans.apache.org. Since a few > >>>>> minutes, the netbeans.org/downloads page redirects to the Apache > >>>> NetBeans > >>>>> download page. > >>>>> > >>>>> In short, until we have all the documentation that is on > netbeans.org > >>>>> safely housed and structured at Apache, and we have redirects etc in > >>>> place, > >>>>> netbeans.org will as far as possible simply have all/most of its > links > >>>>> redirect to netbeans.apache.org. > >>>>> > >>>>> Gj > >>>>> > >>>>> > >>>>> On Fri, Dec 28, 2018 at 7:35 PM Antonio <anto...@vieiro.net> wrote: > >>>>> > >>>>>> Hi all, > >>>>>> > >>>>>> As you know the current https://netbeans.apache.org was launched > >> about > >>>>>> one year ago and has gone through different enhancements. > >>>>>> > >>>>>> During this year we've added some wiki pages, some content, our > >> download > >>>>>> pages are compliant with Apache requirements and we're also > compliant > >>>>>> with all Apache Whimsy requirements [1]. > >>>>>> > >>>>>> Before starting integrating the tutorials [2] and before leaving the > >>>>>> incubator we may want to prepare some enhancements. These may range > >> from > >>>>>> look and feel enhancements (banners, images, icons, typography > >>>>>> enhancements, etc.) to content enhancements (sidebars, banners, > etc.), > >>>>>> or some repository enhancements (removing the 'bits.netbeans.org' > >>>>>> directory, for instance, as this is now handled elsewhere) or > tooling > >>>>>> enhancements. > >>>>>> > >>>>>> What do you think could be improved? Are there any volunteers for > the > >>>>>> look and feel enhancements? Do we want to start a "web design > contest" > >>>>>> much like the "NetBeans Logo Contest" we did for our logo? Do we > want > >> to > >>>>>> host a NetBeans blog there as well? > >>>>>> > >>>>>> Ideas and request for enhancements would be most welcome. Let's > >>>> brainstorm. > >>>>>> > >>>>>> Thanks in advance, > >>>>>> Antonio > >>>>>> > >>>>>> [1] > >>>>>> https://whimsy.apache.org/pods/project/netbeans > >>>>>> > >>>>>> [2] > >>>>>> > >>>>>> > >>>> > >> > https://github.com/vieiro/incubator-netbeans-website/tree/feature/third-donation-tutorials/netbeans.apache.org/src/content/kb/docs > >>>>>> > >>>>>> > --------------------------------------------------------------------- > >>>>>> To unsubscribe, e-mail: > dev-unsubscr...@netbeans.incubator.apache.org > >>>>>> For additional commands, e-mail: > >> dev-h...@netbeans.incubator.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.incubator.apache.org > >>>> For additional commands, e-mail: > dev-h...@netbeans.incubator.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.incubator.apache.org > >> For additional commands, e-mail: dev-h...@netbeans.incubator.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.incubator.apache.org > For additional commands, e-mail: dev-h...@netbeans.incubator.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > >
