diff --git a/other/ideas/guidelines.rst b/engine/guidelines/best_practices.rst similarity index 99% rename from other/ideas/guidelines.rst rename to engine/guidelines/best_practices.rst index f3c493a..751dfdb 100644 --- a/other/ideas/guidelines.rst +++ b/engine/guidelines/best_practices.rst @@ -1,7 +1,7 @@ .. _doc_best_practices_for_engine_contributors: -Proposal guidelines -=================== +Best practices for engine contributors +====================================== Introduction ------------ diff --git a/other/ideas/img/best_practices1.png b/engine/guidelines/img/best_practices1.png similarity index 100% rename from other/ideas/img/best_practices1.png rename to engine/guidelines/img/best_practices1.png diff --git a/other/ideas/img/best_practices2.png b/engine/guidelines/img/best_practices2.png similarity index 100% rename from other/ideas/img/best_practices2.png rename to engine/guidelines/img/best_practices2.png diff --git a/other/ideas/img/best_practices3.png b/engine/guidelines/img/best_practices3.png similarity index 100% rename from other/ideas/img/best_practices3.png rename to engine/guidelines/img/best_practices3.png diff --git a/other/ideas/img/best_practices4.png b/engine/guidelines/img/best_practices4.png similarity index 100% rename from other/ideas/img/best_practices4.png rename to engine/guidelines/img/best_practices4.png diff --git a/other/ideas/img/best_practices5.png b/engine/guidelines/img/best_practices5.png similarity index 100% rename from other/ideas/img/best_practices5.png rename to engine/guidelines/img/best_practices5.png diff --git a/other/ideas/img/best_practices6.png b/engine/guidelines/img/best_practices6.png similarity index 100% rename from other/ideas/img/best_practices6.png rename to engine/guidelines/img/best_practices6.png diff --git a/other/ideas/img/best_practices7.png b/engine/guidelines/img/best_practices7.png similarity index 100% rename from other/ideas/img/best_practices7.png rename to engine/guidelines/img/best_practices7.png diff --git a/other/ideas/img/best_practices8.png b/engine/guidelines/img/best_practices8.png similarity index 100% rename from other/ideas/img/best_practices8.png rename to engine/guidelines/img/best_practices8.png diff --git a/engine/guidelines/index.rst b/engine/guidelines/index.rst index 4d06ab9..0fa5663 100644 --- a/engine/guidelines/index.rst +++ b/engine/guidelines/index.rst @@ -7,6 +7,7 @@ This section explains guidelines for contributing to the engine. :maxdepth: 1 :name: sec-engine-contribution-guidelines + best_practices cpp_usage_guidelines code_style diff --git a/index.rst b/index.rst index 6985ea7..4e96797 100644 --- a/index.rst +++ b/index.rst @@ -67,7 +67,7 @@ TODO :caption: Other :name: sec-other - other/ideas/index + other/ideas other/website other/demos other/benchmarks diff --git a/other/ideas.rst b/other/ideas.rst new file mode 100644 index 0000000..c954123 --- /dev/null +++ b/other/ideas.rst @@ -0,0 +1,27 @@ +Contributing ideas and change proposals +======================================= + +We are always looking for suggestions about how to improve the engine. User feedback +is the main driving force behind our decision-making process, and limitations that +you might face while working on your project are a great data point for us when considering +engine enhancements. + +If you experience a usability problem or are missing a feature in the current version of +Godot, start by discussing it with our `community `_. +There may be other, perhaps better, ways to achieve the desired result that community members +could suggest. And you can learn if other users experience the same issue, and figure out +a good solution together. + +If you come up with a well-defined idea for the engine, feel free to open a +`proposal issue `_. +Try to be specific and concrete while describing your problem and your proposed +solution — only actionable proposals can be considered. It is not required, but +if you want to implement it yourself, that's always appreciated! + +If you only have a general idea without specific details, you can open a +`proposal discussion `_. +These can be anything you want, and allow for a free-form discussion in search of +a solution. Once you find one, a proposal issue can be opened. + +Please, read the `readme `_ +document before creating a proposal to learn more about the process. diff --git a/other/ideas/index.rst b/other/ideas/index.rst deleted file mode 100644 index 7786a8f..0000000 --- a/other/ideas/index.rst +++ /dev/null @@ -1,10 +0,0 @@ -Contributing ideas and change proposals -======================================= - -TODO - -.. toctree:: - :maxdepth: 1 - :name: sec-contributing-ideas - - guidelines