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

Lack of structure documentation of new site #162

Closed
Deele opened this issue Aug 29, 2016 · 6 comments
Closed

Lack of structure documentation of new site #162

Deele opened this issue Aug 29, 2016 · 6 comments

Comments

@Deele
Copy link

Deele commented Aug 29, 2016

Seeing current pace of contributions, it seems that there are some sort of issues that cause slowdowns and lack of new contributors joining.

Repository issues is good tool for writing down things that needs to be done, but it lacks general picture and without reading through all the issues, people are not able to understand where this is heading.

From my point of view, except for existing developers that are busy and do not find spare attention resource for new contributions, there could be a problem, that new website project is not properly documented and it is hard to see big picture, zoom in, and contribute one small thing at the time, without sinking deep into whole site and keep context in head that greatly slows down pace of development.

In such documentation, all the pages, all the blocks/widgets should be listed and all the required functions should be noted. Already done and partially finished components should be appropriately marked. Such information would greatly help existing and new contributors get into context of project much faster and have a material for reference when questions arise.

I am willing to contribute work in creating such documentation in format of Wiki section in this repository and I would appreciate any information you, existing contributors, can give, in any (raw) format, that would describe blocks that you are creating or already have created, so that information can be used & converted to mentioned documentation, so that everyone would know in what direction this project is heading.

@samdark
Copy link
Member

samdark commented Aug 29, 2016

I've enabled wiki. Please check if editing is available to you.

@samdark
Copy link
Member

samdark commented Aug 29, 2016

#94 - good source of info.

@cebe
Copy link
Member

cebe commented Aug 29, 2016

What is currently stopping us from switching the new site is the following:

@Deele
Copy link
Author

Deele commented Aug 29, 2016

First iteration is done.

There are many consistency issues that is yet to be dealt with. For example, "About" stuff should go into "about" controller, the same for pages related to "Development", "Support" and "Learn", where "Support" section is my attempt to separate support from development.

@jacmoe
Copy link
Contributor

jacmoe commented Aug 29, 2016 via email

@samdark
Copy link
Member

samdark commented Aug 29, 2016

I agree that this particular suggestion sounds like over-engineering.

@samdark samdark closed this as completed Feb 20, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants