You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@netbeans.apache.org by Antonio <an...@vieiro.net> on 2019/01/06 10:16:13 UTC
Third Donation - Tutorials (was Re: Website enhancement ideas)
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 <an...@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 <an...@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-unsubscribe@netbeans.incubator.apache.org
>>>> For additional commands, e-mail: dev-help@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-unsubscribe@netbeans.incubator.apache.org
>> For additional commands, e-mail: dev-help@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-unsubscribe@netbeans.incubator.apache.org
For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Third Donation - Tutorials (was Re: Website enhancement ideas)
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
Makes sense, perfect.
Gj
On Sun, Jan 6, 2019 at 11:43 AM Antonio <an...@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 <an...@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 <an...@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 <an...@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-unsubscribe@netbeans.incubator.apache.org
> >>>>>> For additional commands, e-mail:
> >> dev-help@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-unsubscribe@netbeans.incubator.apache.org
> >>>> For additional commands, e-mail:
> dev-help@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-unsubscribe@netbeans.incubator.apache.org
> >> For additional commands, e-mail: dev-help@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-unsubscribe@netbeans.incubator.apache.org
> For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>
Re: Third Donation - Tutorials (was Re: Website enhancement ideas)
Posted by Antonio <an...@vieiro.net>.
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 <an...@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 <an...@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 <an...@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-unsubscribe@netbeans.incubator.apache.org
>>>>>> For additional commands, e-mail:
>> dev-help@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-unsubscribe@netbeans.incubator.apache.org
>>>> For additional commands, e-mail: dev-help@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-unsubscribe@netbeans.incubator.apache.org
>> For additional commands, e-mail: dev-help@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-unsubscribe@netbeans.incubator.apache.org
For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Third Donation - Tutorials (was Re: Website enhancement ideas)
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
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 <an...@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 <an...@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 <an...@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-unsubscribe@netbeans.incubator.apache.org
> >>>> For additional commands, e-mail:
> dev-help@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-unsubscribe@netbeans.incubator.apache.org
> >> For additional commands, e-mail: dev-help@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-unsubscribe@netbeans.incubator.apache.org
> For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>