-
-
Notifications
You must be signed in to change notification settings - Fork 100
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
Comments
I've enabled wiki. Please check if editing is available to you. |
#94 - good source of info. |
What is currently stopping us from switching the new site is the following:
|
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. |
About controller? Imo that would be over engineering it.
|
I agree that this particular suggestion sounds like over-engineering. |
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.
The text was updated successfully, but these errors were encountered: