Re: [documentation] Working on Internship Project 'Wiki Update'


Daniel Farrell
 

On Sat, Aug 4, 2018 at 12:32 PM Prateek Chanda <prateekkol21@...> wrote:
Hi,

My name is Prateek and I will be contributing to OpenDaylight Documentation and the wiki improvement as an intern for the upcoming 6 months.

Looking forward to working with you. :)

What timezone are you in? Would you be able to attend the weekly docs call (3PM ET Tuesdays, see wiki/Meetings)?
 
 Last week, I listed down some missing info in the main opendaylight documentation https://docs.opendaylight.org/en/stable-oxygen/index.html as opposed to present in https://wiki.opendaylight.org/view/Main_Page.

For example some info like Installation Guide and other guides are available under the carbon version and not under the present oxygen version. So that needs to be worked upon.

I wanted to know, if I need to push the changes through Gerrit or I can do so through GitHub in the docs repository if it exists on GitHub

You should use Gerrit to send changes. Here are the docs:

 
Also, I would be grateful which areas community members would want to vote as a higher priority changes in the current wiki. If you can list them down as a reply to this thread, that would be helpful as a roadmap.

+1, this is a good way to proceed.

I know it has been mentioned a few times recently that the Project Proposals wiki is out-of-date, has lots of stale content. Would be good to port it to readthedocs and update it along the way.


Also, you could properly document that the Weather page is deprecated in favor of raising Weather-type Jiras. Maybe go ahead and remove the old content (it's always in the history).



You could hunt and destroy duplicate Gerrit guides. I found 6 different ones in a few moments of searching.







We should contribute to and use/build-on this LF-wide Gerrit guide:


Thanks,
Daniel
 


Thanks,
Prateek
_______________________________________________
documentation mailing list
documentation@...
https://lists.opendaylight.org/mailman/listinfo/documentation

Join {integration-dev@lists.opendaylight.org to automatically receive all group messages.