Re: Interested in contributing to Gluster Documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 





On Wed, Oct 12, 2016 at 3:34 PM, Nigel Babu <nigelb@xxxxxxxxxx> wrote:
On Tue, Oct 04, 2016 at 02:22:35PM +0530, Srravya C wrote:
> Hi all,
>
> I am Srravya. I recently came across Gluster on the list of
> communities/organisations participating in Outreachy
> <https://wiki.gnome.org/Outreachy/2016/DecemberMarch>. Upon going through
> the list of projects Gluster has listed for the internship, I noticed that
> one of them is a documentation project. As a new comer to Gluster, I
> believe this would be a good way for me to get started in understanding
> Gluster and make my first contributions.
>
> I would love to interact with community members including developers and
> documentation team members to know how best I can begin working on Gluster.
> It would be great if I could be pointed to any documentation bugs/tasks I
> could pick and also general docs on getting started and initial set up
> steps.
>
> Looking forward to collaborating :)
>
> Cheers,
> Srravya

Hi Srravya,

I suspect you pinged me on IRC over the last week trying to find help.
Apologies in the delay in getting back to you. We've all been at Gluster
Developer Summit and was mostly away from our computers.

 
I'm speaking on behalf of Amye and documentation team members here, so you can
get started right way. A good thing to try is the following:

1. Clone the documentation repo[1].
2. Try to build the documentation (Documentation for mkdocs[2]).

The initial contribution we've listed is for you to find something that needs
improvement and fix it. I would recommend taking a look around to see if you
can find something to do. The bugs we have on file aren't very useful for
initial contributions.

I have a couple of suggestions on something you can start with
1. Install aspell[3] and check for spelling mistakes across the documentation.
   Submit pull requests for fxing them.
2. Install Linkchecker[4] and run it against gluster.readthedocs.org and catch
   any links that lead to 404.

If you have questions, please free to ask on the list and we're happy to help.

[1] https://github.com/gluster/glusterdocs/
[2] http://www.mkdocs.org/
[3] http://aspell.net/
[4] https://pypi.python.org/pypi/LinkChecker

--
nigelb


Hi Nigel, 

Thank you for responding back to me. I am glad I was able to reach out to all of you. 

I cloned the docs repo and have been reading the documentation, also using it simultaneously to try and understand gluster. I attempted resolving some of the open issues but I didn't have much luck with it. I guess I should be more familiar with the project before I work on them. I shall get started on your suggestions and update my progress here. 


Excited,
Srravya

_______________________________________________
Gluster-devel mailing list
Gluster-devel@xxxxxxxxxxx
http://www.gluster.org/mailman/listinfo/gluster-devel

[Index of Archives]     [Gluster Users]     [Ceph Users]     [Linux ARM Kernel]     [Linux ARM]     [Linux Omap]     [Fedora ARM]     [IETF Annouce]     [Security]     [Bugtraq]     [Linux]     [Linux OMAP]     [Linux MIPS]     [eCos]     [Asterisk Internet PBX]     [Linux API]

  Powered by Linux