From 00da73ff0e7eb86de59512223c8a10ee05ad64fa Mon Sep 17 00:00:00 2001 From: Luiz Marin <67489841+luizcmarin@users.noreply.github.com> Date: Fri, 19 Apr 2024 15:48:56 -0300 Subject: [PATCH] Docs folder standardization and other fixes Little adjustments... the 'docs' folder I check everything later when I start translating into Portuguese --- LICENSE.md | 8 +- README.md | 50 +-- {cookbook => docs/cookbook}/en/README.md | 11 +- ...turing-by-use-case-with-vertical-slices.md | 0 {cookbook => docs/cookbook}/en/preface.md | 0 docs/guide/en/README.md | 337 ++++++++---------- docs/internals.md | 11 - .../internals/000-packages.md | 0 .../internals/001-yii-values.md | 0 .../internals/002-issue-workflow.md | 0 .../internals/003-roadmap.md | 0 .../internals/004-namespaces.md | 0 .../internals/005-development-tool.md | 0 .../internals/006-git-commit-messages.md | 0 .../internals/007-exceptions.md | 0 .../internals/008-interfaces.md | 0 .../internals/009-design-decisions.md | 0 .../internals/010-code-style.md | 0 .../internals/011-error-correction.md | 0 012-tests.md => docs/internals/012-tests.md | 0 .../internals/013-code-review.md | 0 014-docs.md => docs/internals/014-docs.md | 0 .../internals/015-phpstorm.md | 0 .../internals/016-security-workflow.md | 0 017-tags.md => docs/internals/017-tags.md | 0 .../internals/018-widgets.md | 0 .../internals/019-view-code-style.md | 0 .../internals/020-package-release.md | 0 .../internals/021-changelog-upgrade.md | 0 .../internals/022-config-groups.md | 0 30 files changed, 189 insertions(+), 228 deletions(-) rename {cookbook => docs/cookbook}/en/README.md (72%) rename {cookbook => docs/cookbook}/en/organizing-code/structuring-by-use-case-with-vertical-slices.md (100%) rename {cookbook => docs/cookbook}/en/preface.md (100%) rename 000-packages.md => docs/internals/000-packages.md (100%) rename 001-yii-values.md => docs/internals/001-yii-values.md (100%) rename 002-issue-workflow.md => docs/internals/002-issue-workflow.md (100%) rename 003-roadmap.md => docs/internals/003-roadmap.md (100%) rename 004-namespaces.md => docs/internals/004-namespaces.md (100%) rename 005-development-tool.md => docs/internals/005-development-tool.md (100%) rename 006-git-commit-messages.md => docs/internals/006-git-commit-messages.md (100%) rename 007-exceptions.md => docs/internals/007-exceptions.md (100%) rename 008-interfaces.md => docs/internals/008-interfaces.md (100%) rename 009-design-decisions.md => docs/internals/009-design-decisions.md (100%) rename 010-code-style.md => docs/internals/010-code-style.md (100%) rename 011-error-correction.md => docs/internals/011-error-correction.md (100%) rename 012-tests.md => docs/internals/012-tests.md (100%) rename 013-code-review.md => docs/internals/013-code-review.md (100%) rename 014-docs.md => docs/internals/014-docs.md (100%) rename 015-phpstorm.md => docs/internals/015-phpstorm.md (100%) rename 016-security-workflow.md => docs/internals/016-security-workflow.md (100%) rename 017-tags.md => docs/internals/017-tags.md (100%) rename 018-widgets.md => docs/internals/018-widgets.md (100%) rename 019-view-code-style.md => docs/internals/019-view-code-style.md (100%) rename 020-package-release.md => docs/internals/020-package-release.md (100%) rename 021-changelog-upgrade.md => docs/internals/021-changelog-upgrade.md (100%) rename 022-config-groups.md => docs/internals/022-config-groups.md (100%) diff --git a/LICENSE.md b/LICENSE.md index bc5674f..6a920d6 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -1,17 +1,17 @@ -Copyright © 2008 by Yii Software (https://www.yiiframework.com/) +Copyright © 2008 by Yii Software () All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - * Redistributions of source code must retain the above copyright +* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - * Redistributions in binary form must reproduce the above copyright +* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - * Neither the name of Yii Software nor the names of its +* Neither the name of Yii Software nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. diff --git a/README.md b/README.md index 9ad298e..1a11a1f 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,33 @@ # The definitive guide to Yii 3.0 -- [English](guide/en) +- [English](docs/guide/en/README.md) # Yii3 community cookbook -- [English](cookbook/en) +- [English](docs/cookbook/en) # Internals -- [000 - Packages](000-packages.md) -- [001 - Yii goals and values](001-yii-values.md) -- [002 - Issue workflow](002-issue-workflow.md) -- [003 - Roadmap](003-roadmap.md) -- [004 - Namespaces](004-namespaces.md) -- [005 - Development tool](005-development-tool.md) -- [006 - Git commit messages](006-git-commit-messages.md) -- [007 - Exceptions](007-exceptions.md) -- [008 - Interfaces](008-interfaces.md) -- [009 - Design decisions](009-design-decisions.md) -- [010 - Code style](010-code-style.md) -- [011 - Error correction](011-error-correction.md) -- [012 - Tests](012-tests.md) -- [013 - Code review](013-code-review.md) -- [014 - Documentation](014-docs.md) -- [015 - PhpStorm metadata and attributes](015-phpstorm.md) -- [016 - Security workflow](016-security-workflow.md) -- [017 - Tags](017-tags.md) -- [018 - Widgets](018-widgets.md) -- [019 - View code style](019-view-code-style.md) -- [020 - Package release](020-package-release.md) -- [021 - Changelog and upgrade](021-changelog-upgrade.md) -- [022 - Config groups](022-config-groups.md) +- [000 - Packages](docs/internals/000-packages.md) +- [001 - Yii goals and values](docs/internals/001-yii-values.md) +- [002 - Issue workflow](docs/internals/002-issue-workflow.md) +- [003 - Roadmap](docs/internals/003-roadmap.md) +- [004 - Namespaces](docs/internals/004-namespaces.md) +- [005 - Development tool](docs/internals/005-development-tool.md) +- [006 - Git commit messages](docs/internals/006-git-commit-messages.md) +- [007 - Exceptions](docs/internals/007-exceptions.md) +- [008 - Interfaces](docs/internals/008-interfaces.md) +- [009 - Design decisions](docs/internals/009-design-decisions.md) +- [010 - Code style](docs/internals/010-code-style.md) +- [011 - Error correction](docs/internals/011-error-correction.md) +- [012 - Tests](docs/internals/012-tests.md) +- [013 - Code review](docs/internals/013-code-review.md) +- [014 - Documentation](docs/internals/014-docs.md) +- [015 - PhpStorm metadata and attributes](docs/internals/015-phpstorm.md) +- [016 - Security workflow](docs/internals/016-security-workflow.md) +- [017 - Tags](docs/internals/017-tags.md) +- [018 - Widgets](docs/internals/018-widgets.md) +- [019 - View code style](docs/internals/019-view-code-style.md) +- [020 - Package release](docs/internals/020-package-release.md) +- [021 - Changelog and upgrade](docs/internals/021-changelog-upgrade.md) +- [022 - Config groups](docs/internals/022-config-groups.md) diff --git a/cookbook/en/README.md b/docs/cookbook/en/README.md similarity index 72% rename from cookbook/en/README.md rename to docs/cookbook/en/README.md index 5864c95..3e88c33 100644 --- a/cookbook/en/README.md +++ b/docs/cookbook/en/README.md @@ -8,16 +8,15 @@ PHP framework. Feel free to pull request your own writings. Team members will review it, give feedback and merge the best possible way. -This book conforms to the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs). +This book conforms to the [Terms of Yii Documentation.](https://www.yiiframework.com/license#docs) --- -[Preface](preface.md) +## Documentation -Getting started ---------------- +- [Preface](preface.md) +- Getting started -Organizing code ---------------- +### Organizing code - [Structuring code by use-case with vertical slices](organizing-code/structuring-by-use-case-with-vertical-slices.md) diff --git a/cookbook/en/organizing-code/structuring-by-use-case-with-vertical-slices.md b/docs/cookbook/en/organizing-code/structuring-by-use-case-with-vertical-slices.md similarity index 100% rename from cookbook/en/organizing-code/structuring-by-use-case-with-vertical-slices.md rename to docs/cookbook/en/organizing-code/structuring-by-use-case-with-vertical-slices.md diff --git a/cookbook/en/preface.md b/docs/cookbook/en/preface.md similarity index 100% rename from cookbook/en/preface.md rename to docs/cookbook/en/preface.md diff --git a/docs/guide/en/README.md b/docs/guide/en/README.md index 60d12df..5249ffd 100644 --- a/docs/guide/en/README.md +++ b/docs/guide/en/README.md @@ -2,185 +2,158 @@ This guide is released under the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs). -Introduction + ------------- - -* [About Yii](intro/what-is-yii.md) + -* [Upgrading from version 2.0](intro/upgrade-from-v2.md) + - - -Getting started - ---------------- - -* [What do you need to know](start/prerequisites.md) + -* [Creating a project](start/creating-project.md) + -* [Running applications](start/workflow.md) + -* [Saying hello](start/hello.md) + -* [Working with forms](start/forms.md) + -* [Working with databases](start/databases.md) ! -* [Generating code with Gii](start/gii.md) - -* [Looking ahead](start/looking-ahead.md) + - - -Application structure + ---------------------- - -* [Application structure overview](structure/overview.md) + -* [Entry scripts](structure/entry-script.md) + -* [Application](structure/application.md) + -* [Service components](structure/service.md) + -* [Actions](structure/action.md) + -* [Domain](structure/domain.md) + -* [Middleware](structure/middleware.md) + -* [Packages](structure/package.md) + - -Key concepts + ------------- - -* [Class autoloading](concept/autoloading.md) + -* [Dependency injection container](concept/di-container.md) + -* [Configuration](concept/configuration.md) + -* [Aliases](concept/aliases.md) + -* [Events](concept/events.md) + - -Handling requests + ------------------ - -* [Routing and URL generation](runtime/routing.md) + -* [Request](runtime/request.md) + -* [Response](runtime/response.md) + -* [Sessions](runtime/sessions.md) + -* [Cookies](runtime/cookies.md) + -* [Handling errors](runtime/handling-errors.md) + -* [Logging](runtime/logging.md) + - -Views - ------ - -* [Views](views/view.md) - -* [Widgets](views/widget.md) - -* [Assets](views/asset.md) - -* [Working with client scripts](views/client-scripts.md) - -* [Theming](views/theming.md) - -* [Template engines](views/template-engines.md) - - - -Working with databases +- ----------------------- - -* [Database access objects](db-dao.md): Connecting to a database, basic queries, transactions, and schema manipulation -* [Query builder](db-query-builder.md): Querying the database using a simple abstraction layer -* [Active record](db-active-record.md): The Active Record ORM, retrieving and manipulating records, and defining relations -* [Migrations](databases/db-migrations.md): + - -Getting data from users - ------------------------ - -* [Creating forms](input/forms.md) - -* [Validating input](https://github.com/yiisoft/validator/blob/master/docs/guide/en/README.md) + -* [Uploading files](input/file-upload.md) - -* [Collecting tabular input](input/tabular-input.md) - - - -Displaying data - ---------------- - -* [Data formatting](output/formatting.md) - -* [Pagination](output/pagination.md) - -* [Sorting](output/sorting.md) - -* [Data providers](output/data-providers.md) - -* [Data widgets](output/data-widgets.md) - - -Security +- --------- - -* [Security overview](security/overview.md) + -* [Authentication](security/authentication.md) + -* [Authorization](security/authorization.md) +- -* [Working with passwords](security/passwords.md) + -* [Cryptography](security/cryptography.md) + -* [Best practices](security/best-practices.md) + - - -Caching +- -------- - -* [Caching overview](caching/overview.md) + -* [Data caching](caching/data.md) + -* [Fragment caching](caching/fragment.md) - -* [Page caching](caching/page.md) - -* [HTTP caching](caching/http.md) - - - -REST APIs - ------------ - -* [Quick start](rest/quick-start.md) -* [Resources](rest/resources.md) -* [Controllers](rest/controllers.md) -* [Routing](rest/routing.md) -* [Authentication](rest/authentication.md) -* [Rate limiting](rest/rate-limiting.md) -* [Versioning](rest/versioning.md) -* [Error handling](rest/error-handling.md) - -Development tools - ------------------ - -* Debug toolbar and debugger -* Generating code using Gii -* Generating API documentation - - -Testing - -------- - -* [Testing overview](testing/overview.md) -* [Testing environment setup](testing/environment-setup.md) -* [Unit tests](testing/unit.md) -* [Functional tests](testing/functional.md) -* [Acceptance tests](testing/acceptance.md) -* [Fixtures](testing/fixtures.md) - - -Special topics - --------------- - -* [Building application from scratch](tutorial/start-from-scratch.md) - -* [Console applications](tutorial/console-applications.md) + -* [Docker](tutorial/docker.md) - -* [Internationalization](tutorial/i18n.md) - -* [Mailing](tutorial/mailing.md) + -* [Performance tuning](tutorial/performance-tuning.md) + -* [Using Yii with event loop](tutorial/using-with-event-loop.md) + -* [Using Yii with RoadRunner](tutorial/using-yii-with-roadrunner.md) + -* [Using Yii with Swoole](tutorial/using-yii-with-swoole.md) + - -Widgets - -------- - -* [GridView](https://www.yiiframework.com/doc-2.0/yii-grid-gridview.html) -* [ListView](https://www.yiiframework.com/doc-2.0/yii-widgets-listview.html) -* [DetailView](https://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html) -* [ActiveForm](https://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform) -* [Menu](https://www.yiiframework.com/doc-2.0/yii-widgets-menu.html) -* [LinkPager](https://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html) -* [LinkSorter](https://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html) -* [Bootstrap widgets](https://www.yiiframework.com/extension/yiisoft/yii2-bootstrap/doc/guide) - - -Helpers + -------- - -* [Arrays](https://github.com/yiisoft/arrays/) -* [Files](https://github.com/yiisoft/files/) -* [Html](https://github.com/yiisoft/html/) -* [Json](https://github.com/yiisoft/json) -* [Network utilities](https://github.com/yiisoft/network-utilities/) -* [VarDumper](https://github.com/yiisoft/var-dumper) -* [Strings](https://github.com/yiisoft/strings) - -Extras + ------- - -* [Glossary](glossary.md) +## Introduction +----- + +- [About Yii](intro/what-is-yii.md) + +- [Upgrading from version 2.0](intro/upgrade-from-v2.md) + + +## Getting started - + +- [What do you need to know](start/prerequisites.md) + +- [Creating a project](start/creating-project.md) + +- [Running applications](start/workflow.md) + +- [Saying hello](start/hello.md) + +- [Working with forms](start/forms.md) + +- [Working with databases](start/databases.md) ! +- [Generating code with Gii](start/gii.md) - +- [Looking ahead](start/looking-ahead.md) + + +## Application structure + + +- [Application structure overview](structure/overview.md) + +- [Entry scripts](structure/entry-script.md) + +- [Application](structure/application.md) + +- [Service components](structure/service.md) + +- [Actions](structure/action.md) + +- [Domain](structure/domain.md) + +- [Middleware](structure/middleware.md) + +- [Packages](structure/package.md) + + +## Key concepts + + +- [Class autoloading](concept/autoloading.md) + +- [Dependency injection container](concept/di-container.md) + +- [Configuration](concept/configuration.md) + +- [Aliases](concept/aliases.md) + +- [Events](concept/events.md) + + +## Handling requests + + +- [Routing and URL generation](runtime/routing.md) + +- [Request](runtime/request.md) + +- [Response](runtime/response.md) + +- [Sessions](runtime/sessions.md) + +- [Cookies](runtime/cookies.md) + +- [Handling errors](runtime/handling-errors.md) + +- [Logging](runtime/logging.md) + + +## Views - + +- [Views](views/view.md) - +- [Widgets](views/widget.md) - +- [Assets](views/asset.md) - +- [Working with client scripts](views/client-scripts.md) - +- [Theming](views/theming.md) - +- [Template engines](views/template-engines.md) - + +## Working with databases +- + +- [Database access objects](db-dao.md): Connecting to a database, basic queries, transactions, and schema manipulation +- [Query builder](db-query-builder.md): Querying the database using a simple abstraction layer +- [Active record](db-active-record.md): The Active Record ORM, retrieving and manipulating records, and defining relations +- [Migrations](databases/db-migrations.md): + + +## Getting data from users - + +- [Creating forms](input/forms.md) - +- [Validating input](https://github.com/yiisoft/validator/blob/master/docs/guide/en/README.md) + +- [Uploading files](input/file-upload.md) - +- [Collecting tabular input](input/tabular-input.md) - + +## Displaying data - + +- [Data formatting](output/formatting.md) - +- [Pagination](output/pagination.md) - +- [Sorting](output/sorting.md) - +- [Data providers](output/data-providers.md) - +- [Data widgets](output/data-widgets.md) - + +## Security +- + +- [Security overview](security/overview.md) + +- [Authentication](security/authentication.md) + +- [Authorization](security/authorization.md) +- +- [Working with passwords](security/passwords.md) + +- [Cryptography](security/cryptography.md) + +- [Best practices](security/best-practices.md) + + +## Caching +- + +- [Caching overview](caching/overview.md) + +- [Data caching](caching/data.md) + +- [Fragment caching](caching/fragment.md) - +- [Page caching](caching/page.md) - +- [HTTP caching](caching/http.md) - + +## REST APIs - + +- [Quick start](rest/quick-start.md) +- [Resources](rest/resources.md) +- [Controllers](rest/controllers.md) +- [Routing](rest/routing.md) +- [Authentication](rest/authentication.md) +- [Rate limiting](rest/rate-limiting.md) +- [Versioning](rest/versioning.md) +- [Error handling](rest/error-handling.md) + +## Development tools - + +- Debug toolbar and debugger +- Generating code using Gii +- Generating API documentation + +## Testing - + +- [Testing overview](testing/overview.md) +- [Testing environment setup](testing/environment-setup.md) +- [Unit tests](testing/unit.md) +- [Functional tests](testing/functional.md) +- [Acceptance tests](testing/acceptance.md) +- [Fixtures](testing/fixtures.md) + +## Widgets + +- [GridView](https://www.yiiframework.com/doc-2.0/yii-grid-gridview.html) +- [ListView](https://www.yiiframework.com/doc-2.0/yii-widgets-listview.html) +- [DetailView](https://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html) +- [ActiveForm](https://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform) +- [Menu](https://www.yiiframework.com/doc-2.0/yii-widgets-menu.html) +- [LinkPager](https://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html) +- [LinkSorter](https://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html) +- [Bootstrap widgets](https://www.yiiframework.com/extension/yiisoft/yii2-bootstrap/doc/guide) + +## Helpers + + +- [Arrays](https://github.com/yiisoft/arrays/) +- [Files](https://github.com/yiisoft/files/) +- [Html](https://github.com/yiisoft/html/) +- [Json](https://github.com/yiisoft/json) +- [Network utilities](https://github.com/yiisoft/network-utilities/) +- [VarDumper](https://github.com/yiisoft/var-dumper) +- [Strings](https://github.com/yiisoft/strings) + +## Special topics - + +- [Building application from scratch](tutorial/start-from-scratch.md) - +- [Console applications](tutorial/console-applications.md) + +- [Docker](tutorial/docker.md) - +- [Internationalization](tutorial/i18n.md) - +- [Mailing](tutorial/mailing.md) + +- [Performance tuning](tutorial/performance-tuning.md) + +- [Using Yii with event loop](tutorial/using-with-event-loop.md) + +- [Using Yii with RoadRunner](tutorial/using-yii-with-roadrunner.md) + +- [Using Yii with Swoole](tutorial/using-yii-with-swoole.md) + + +## Extras + + +- [Glossary](glossary.md) diff --git a/docs/internals.md b/docs/internals.md index b715d9f..3ca962d 100644 --- a/docs/internals.md +++ b/docs/internals.md @@ -33,14 +33,3 @@ use either newest or any specific version of PHP: ```shell ./vendor/bin/rector ``` - -## Dependencies - -Use [ComposerRequireChecker](https://github.com/maglnet/ComposerRequireChecker) to detect transitive -[Composer](https://getcomposer.org/) dependencies. - -To run the checker, execute the following command: - -```shell -./vendor/bin/composer-require-checker -``` diff --git a/000-packages.md b/docs/internals/000-packages.md similarity index 100% rename from 000-packages.md rename to docs/internals/000-packages.md diff --git a/001-yii-values.md b/docs/internals/001-yii-values.md similarity index 100% rename from 001-yii-values.md rename to docs/internals/001-yii-values.md diff --git a/002-issue-workflow.md b/docs/internals/002-issue-workflow.md similarity index 100% rename from 002-issue-workflow.md rename to docs/internals/002-issue-workflow.md diff --git a/003-roadmap.md b/docs/internals/003-roadmap.md similarity index 100% rename from 003-roadmap.md rename to docs/internals/003-roadmap.md diff --git a/004-namespaces.md b/docs/internals/004-namespaces.md similarity index 100% rename from 004-namespaces.md rename to docs/internals/004-namespaces.md diff --git a/005-development-tool.md b/docs/internals/005-development-tool.md similarity index 100% rename from 005-development-tool.md rename to docs/internals/005-development-tool.md diff --git a/006-git-commit-messages.md b/docs/internals/006-git-commit-messages.md similarity index 100% rename from 006-git-commit-messages.md rename to docs/internals/006-git-commit-messages.md diff --git a/007-exceptions.md b/docs/internals/007-exceptions.md similarity index 100% rename from 007-exceptions.md rename to docs/internals/007-exceptions.md diff --git a/008-interfaces.md b/docs/internals/008-interfaces.md similarity index 100% rename from 008-interfaces.md rename to docs/internals/008-interfaces.md diff --git a/009-design-decisions.md b/docs/internals/009-design-decisions.md similarity index 100% rename from 009-design-decisions.md rename to docs/internals/009-design-decisions.md diff --git a/010-code-style.md b/docs/internals/010-code-style.md similarity index 100% rename from 010-code-style.md rename to docs/internals/010-code-style.md diff --git a/011-error-correction.md b/docs/internals/011-error-correction.md similarity index 100% rename from 011-error-correction.md rename to docs/internals/011-error-correction.md diff --git a/012-tests.md b/docs/internals/012-tests.md similarity index 100% rename from 012-tests.md rename to docs/internals/012-tests.md diff --git a/013-code-review.md b/docs/internals/013-code-review.md similarity index 100% rename from 013-code-review.md rename to docs/internals/013-code-review.md diff --git a/014-docs.md b/docs/internals/014-docs.md similarity index 100% rename from 014-docs.md rename to docs/internals/014-docs.md diff --git a/015-phpstorm.md b/docs/internals/015-phpstorm.md similarity index 100% rename from 015-phpstorm.md rename to docs/internals/015-phpstorm.md diff --git a/016-security-workflow.md b/docs/internals/016-security-workflow.md similarity index 100% rename from 016-security-workflow.md rename to docs/internals/016-security-workflow.md diff --git a/017-tags.md b/docs/internals/017-tags.md similarity index 100% rename from 017-tags.md rename to docs/internals/017-tags.md diff --git a/018-widgets.md b/docs/internals/018-widgets.md similarity index 100% rename from 018-widgets.md rename to docs/internals/018-widgets.md diff --git a/019-view-code-style.md b/docs/internals/019-view-code-style.md similarity index 100% rename from 019-view-code-style.md rename to docs/internals/019-view-code-style.md diff --git a/020-package-release.md b/docs/internals/020-package-release.md similarity index 100% rename from 020-package-release.md rename to docs/internals/020-package-release.md diff --git a/021-changelog-upgrade.md b/docs/internals/021-changelog-upgrade.md similarity index 100% rename from 021-changelog-upgrade.md rename to docs/internals/021-changelog-upgrade.md diff --git a/022-config-groups.md b/docs/internals/022-config-groups.md similarity index 100% rename from 022-config-groups.md rename to docs/internals/022-config-groups.md