Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add content to Development page #137

Open
veroandreo opened this issue May 3, 2020 · 12 comments
Open

add content to Development page #137

veroandreo opened this issue May 3, 2020 · 12 comments
Labels
help wanted Extra attention is needed

Comments

@veroandreo
Copy link
Contributor

Since most of the content in the former development page was moved to the landing page of Get involved, now we need to add some more info only about development into the sub-page. Ideas?

@veroandreo veroandreo self-assigned this May 3, 2020
@lucadelu
Copy link
Contributor

lucadelu commented May 3, 2020

I already suggested to remove development page in previous discussion, I'm still of the same opinion

@neteler neteler added this to the Initial release milestone May 8, 2020
@veroandreo
Copy link
Contributor Author

I don't think we should remove it. I think a minimum explanation of how grass development works, link to development manuals and style guides, requirements to fulfill, must be there. Moreover, once we agree on a roadmap, I suggest to include it there. So it's easily discoverable and not hidden within trac. See for example these 3 QGIS pages:

In this line of thought, some of the content in these pages might be recycled, for example, to get something similar to what QGIS have:

@veroandreo veroandreo removed their assignment May 17, 2020
@veroandreo veroandreo added the help wanted Extra attention is needed label May 17, 2020
@veroandreo
Copy link
Contributor Author

Any volunteers more familiar with Development stuff as to add some content to this page??

@wenzeslaus
Copy link
Member

I don't know how this fits into this discussion, but there is a file https://github.com/OSGeo/grass/blob/master/CONTRIBUTING.md which should the somewhat the primary place at least for contributing directly to the main repo.

@mlennert
Copy link
Contributor

This also might be a good entry point for new developers: https://grasswiki.osgeo.org/wiki/GRASS_GIS_APIs.

@ninsbl
Copy link
Member

ninsbl commented May 20, 2020

Personally, I would probably move the content from the landing page (BTW. quicklinks at the top would be helpful here given the length and different topics) to "Development" and the content from Development (with minor addition of info on the different ways people can contribute and links to the respective sub-pages) to the landing page. Adding links to external sites that are listed above can be a good way not overload the new website. However, it seems that some consolidation and update of the different pages would be necessary in the long run.
I can try to come up with a proposal / PR tonight if you like...

@veroandreo
Copy link
Contributor Author

veroandreo commented May 20, 2020

Personally, I would probably move the content from the landing page (BTW. quicklinks at the top would be helpful here given the length and different topics) to "Development" and the content from Development (with minor addition of info on the different ways people can contribute and links to the respective sub-pages) to the landing page.

I did exactly the opposite (move most of development page to the landing page of contribute in #118) because that's what we had agreed in the call and was documented in #77.
I really like how that landing page looks like... and the content fits... it's about the many ways you can contribute to the project or get involved with the community.
Instead, the development page within the contribute section should be more technical for those contributing only to the source code

@mlennert
Copy link
Contributor

I also like the landing page the way it is now. Development should really focus on programming, so as a baseline it should provide a series of (commented) links to relevant resources. I see at least:

Plus maybe a link to the grass-dev list ?

At this stage, I think we should create the minimal page needed for the site to go online. Future enhancements will always be possible (but will also depend on the future uses of the grasswiki, trac wiki and github for such documentation).

@mlennert mlennert added the blocker Breaks the website label May 20, 2020
@lucadelu
Copy link
Contributor

I start to work on it, do we need more text?

@mlennert
Copy link
Contributor

I'm removing the blocker flag as I think the page is ok for release as is right now. Obviously it could probably be improved by giving more guidance to the different links in the quick links section, i.e. some explanation of what each page contains.

@mlennert mlennert removed the blocker Breaks the website label Jun 16, 2020
@mlennert mlennert moved this from To do to In progress in Web site content migration Jun 16, 2020
@mlennert
Copy link
Contributor

@veroandreo what do you think ?

@veroandreo
Copy link
Contributor Author

I agree with removing the blocker tag (that you did already :)) but let's keep this issue open, as it contains a good list of sources where to obtain info from for further improvement of the Development page

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed
Projects
Development

No branches or pull requests

6 participants