You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@allura.apache.org by Tim Van Steenburgh <tv...@gmail.com> on 2014/01/03 19:08:20 UTC
Guide for new contributors
We've published a Getting Started guide for new Allura contributors at http://allura.sourceforge.net/docs/contributing.html. To accompany the guide, we've created a new 'bitesize' ticket label to identify open tickets that may be suitable for new contributors. Bitesize tickets can be found at https://sourceforge.net/p/allura/tickets/search/?q=labels%3Abitesize (link is also included in the docs).
If you're interested in contributing to Allura, don't be intimidated - jump in and we'll help you!
--
Tim Van Steenburgh
Re: Guide for new contributors
Posted by Wayne Witzel III <ww...@gmail.com>.
Nice work!
I like the idea of having a "Using Allura" section, but I think screencasts
are better for that type of information. We really don't have a good way to
distribute them, maybe embedding YouTube/Vimeo videos in to the Using
Allura section (if that is possible?). I'd be willing to write a script and
put a screencast together if you think that would be useful.
On Fri, Jan 3, 2014 at 1:36 PM, Dave Brondsema <da...@brondsema.net> wrote:
> On 1/3/14 1:08 PM, Tim Van Steenburgh wrote:
> > We've published a Getting Started guide for new Allura contributors at
> http://allura.sourceforge.net/docs/contributing.html. To accompany the
> guide, we've created a new 'bitesize' ticket label to identify open tickets
> that may be suitable for new contributors. Bitesize tickets can be found at
> https://sourceforge.net/p/allura/tickets/search/?q=labels%3Abitesize(link is also included in the docs).
> >
> > If you're interested in contributing to Allura, don't be intimidated -
> jump in and we'll help you!
> >
>
> Yay :) We've been sorely missing that type of guide.
>
> I've had one person suggest to me that docs about "Using Allura" would be
> helpful. End-user docs about setting up a project, using the tools, etc.
> We
> don't have any of that in our docs. The SourceForge support docs at
> https://sourceforge.net/p/forge/documentation/Docs%20Home/ do cover those
> topics, but also cover other SourceForge-specific things.
>
> What does everyone thing about adding a "Using Allura" section to our docs,
> initially containing specific targeted links to SourceForge pages, with
> appropriate notes/disclaimer that there are some SourceForge-specific items
> within those pages?
>
>
> --
> Dave Brondsema : dave@brondsema.net
> http://www.brondsema.net : personal
> http://www.splike.com : programming
> <><
>
Re: Guide for new contributors
Posted by Daniel Hinojosa <dh...@slashdotmedia.com>.
this.
On Tue, Jan 7, 2014 at 8:11 AM, Dave Brondsema <da...@brondsema.net> wrote:
> On 1/3/14 3:52 PM, Tim Van Steenburgh wrote:
> > On Friday, January 3, 2014 at 1:36 PM, Dave Brondsema wrote:
> >> On 1/3/14 1:08 PM, Tim Van Steenburgh wrote:
> >>> We've published a Getting Started guide for new Allura contributors at
> http://allura.sourceforge.net/docs/contributing.html. To accompany the
> guide, we've created a new 'bitesize' ticket label to identify open tickets
> that may be suitable for new contributors. Bitesize tickets can be found at
> https://sourceforge.net/p/allura/tickets/search/?q=labels%3Abitesize(link is also included in the docs).
> >>>
> >>> If you're interested in contributing to Allura, don't be intimidated -
> jump in and we'll help you!
> >>
> >> Yay :) We've been sorely missing that type of guide.
> >>
> >> I've had one person suggest to me that docs about "Using Allura" would
> be
> >> helpful. End-user docs about setting up a project, using the tools,
> etc. We
> >> don't have any of that in our docs. The SourceForge support docs at
> >> https://sourceforge.net/p/forge/documentation/Docs%20Home/ do cover
> those
> >> topics, but also cover other SourceForge-specific things.
> >>
> >> What does everyone thing about adding a "Using Allura" section to our
> docs,
> >> initially containing specific targeted links to SourceForge pages, with
> >> appropriate notes/disclaimer that there are some SourceForge-specific
> items
> >> within those pages?
> >>
> > I agree that we should have docs on "Using Allura." Starting with links
> to SF docs is a perfectly acceptable beginning imho - certainly better than
> nothing. If we (or anyone) has the bandwidth to eventually add screencasts
> and such, even better.
> >
> > Here's an existing ticket that lists some stuff that would be needed in
> such documentation: https://sourceforge.net/p/allura/tickets/5943/
> >
> > Other doc-related tickets here:
> https://sourceforge.net/p/allura/tickets/search/?q=labels%3Adocs+%26%26+status%3Aopen
>
> Got that started at http://allura.sourceforge.net/docs/using.html
>
> Wayne, screencasts would be great, but one downside is that when they get
> out of
> date there's no easy way to update them (whereas text and screenshots can
> be
> updated in-place).
>
>
> --
> Dave Brondsema : dave@brondsema.net
> http://www.brondsema.net : personal
> http://www.splike.com : programming
> <><
>
--
*Daniel Hinojosa*
*Community Manager, SourceForge / Slashdot Media*
p: 415.890.3608
e: d@slashdotmedia.com
Twitter: @hinojosad
Skype: hinojosad
Re: Guide for new contributors
Posted by Dave Brondsema <da...@brondsema.net>.
On 1/3/14 3:52 PM, Tim Van Steenburgh wrote:
> On Friday, January 3, 2014 at 1:36 PM, Dave Brondsema wrote:
>> On 1/3/14 1:08 PM, Tim Van Steenburgh wrote:
>>> We've published a Getting Started guide for new Allura contributors at http://allura.sourceforge.net/docs/contributing.html. To accompany the guide, we've created a new 'bitesize' ticket label to identify open tickets that may be suitable for new contributors. Bitesize tickets can be found at https://sourceforge.net/p/allura/tickets/search/?q=labels%3Abitesize (link is also included in the docs).
>>>
>>> If you're interested in contributing to Allura, don't be intimidated - jump in and we'll help you!
>>
>> Yay :) We've been sorely missing that type of guide.
>>
>> I've had one person suggest to me that docs about "Using Allura" would be
>> helpful. End-user docs about setting up a project, using the tools, etc. We
>> don't have any of that in our docs. The SourceForge support docs at
>> https://sourceforge.net/p/forge/documentation/Docs%20Home/ do cover those
>> topics, but also cover other SourceForge-specific things.
>>
>> What does everyone thing about adding a "Using Allura" section to our docs,
>> initially containing specific targeted links to SourceForge pages, with
>> appropriate notes/disclaimer that there are some SourceForge-specific items
>> within those pages?
>>
> I agree that we should have docs on "Using Allura." Starting with links to SF docs is a perfectly acceptable beginning imho - certainly better than nothing. If we (or anyone) has the bandwidth to eventually add screencasts and such, even better.
>
> Here's an existing ticket that lists some stuff that would be needed in such documentation: https://sourceforge.net/p/allura/tickets/5943/
>
> Other doc-related tickets here: https://sourceforge.net/p/allura/tickets/search/?q=labels%3Adocs+%26%26+status%3Aopen
Got that started at http://allura.sourceforge.net/docs/using.html
Wayne, screencasts would be great, but one downside is that when they get out of
date there's no easy way to update them (whereas text and screenshots can be
updated in-place).
--
Dave Brondsema : dave@brondsema.net
http://www.brondsema.net : personal
http://www.splike.com : programming
<><
Re: Guide for new contributors
Posted by Tim Van Steenburgh <tv...@gmail.com>.
On Friday, January 3, 2014 at 1:36 PM, Dave Brondsema wrote:
> On 1/3/14 1:08 PM, Tim Van Steenburgh wrote:
> > We've published a Getting Started guide for new Allura contributors at http://allura.sourceforge.net/docs/contributing.html. To accompany the guide, we've created a new 'bitesize' ticket label to identify open tickets that may be suitable for new contributors. Bitesize tickets can be found at https://sourceforge.net/p/allura/tickets/search/?q=labels%3Abitesize (link is also included in the docs).
> >
> > If you're interested in contributing to Allura, don't be intimidated - jump in and we'll help you!
>
> Yay :) We've been sorely missing that type of guide.
>
> I've had one person suggest to me that docs about "Using Allura" would be
> helpful. End-user docs about setting up a project, using the tools, etc. We
> don't have any of that in our docs. The SourceForge support docs at
> https://sourceforge.net/p/forge/documentation/Docs%20Home/ do cover those
> topics, but also cover other SourceForge-specific things.
>
> What does everyone thing about adding a "Using Allura" section to our docs,
> initially containing specific targeted links to SourceForge pages, with
> appropriate notes/disclaimer that there are some SourceForge-specific items
> within those pages?
>
I agree that we should have docs on "Using Allura." Starting with links to SF docs is a perfectly acceptable beginning imho - certainly better than nothing. If we (or anyone) has the bandwidth to eventually add screencasts and such, even better.
Here's an existing ticket that lists some stuff that would be needed in such documentation: https://sourceforge.net/p/allura/tickets/5943/
Other doc-related tickets here: https://sourceforge.net/p/allura/tickets/search/?q=labels%3Adocs+%26%26+status%3Aopen
>
>
> --
> Dave Brondsema : dave@brondsema.net (mailto:dave@brondsema.net)
> http://www.brondsema.net : personal
> http://www.splike.com : programming
> <><
>
>
Re: Guide for new contributors
Posted by Dave Brondsema <da...@brondsema.net>.
On 1/3/14 1:08 PM, Tim Van Steenburgh wrote:
> We've published a Getting Started guide for new Allura contributors at http://allura.sourceforge.net/docs/contributing.html. To accompany the guide, we've created a new 'bitesize' ticket label to identify open tickets that may be suitable for new contributors. Bitesize tickets can be found at https://sourceforge.net/p/allura/tickets/search/?q=labels%3Abitesize (link is also included in the docs).
>
> If you're interested in contributing to Allura, don't be intimidated - jump in and we'll help you!
>
Yay :) We've been sorely missing that type of guide.
I've had one person suggest to me that docs about "Using Allura" would be
helpful. End-user docs about setting up a project, using the tools, etc. We
don't have any of that in our docs. The SourceForge support docs at
https://sourceforge.net/p/forge/documentation/Docs%20Home/ do cover those
topics, but also cover other SourceForge-specific things.
What does everyone thing about adding a "Using Allura" section to our docs,
initially containing specific targeted links to SourceForge pages, with
appropriate notes/disclaimer that there are some SourceForge-specific items
within those pages?
--
Dave Brondsema : dave@brondsema.net
http://www.brondsema.net : personal
http://www.splike.com : programming
<><