diff options
author | Safiyyah Moosa <safiyyah.moosa@qt.io> | 2023-08-15 10:50:26 +0200 |
---|---|---|
committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2023-09-23 09:02:59 +0000 |
commit | 9e6717ed6b4a6cd6f770c730b2b36f461e123219 (patch) | |
tree | f58c3697c1947a3389de02bcc0c3d4f11527a521 | |
parent | 98b3ee4067520196586fdf4fc4e8b73eccd0a8e0 (diff) |
Doc: Create README template
There are many Qt submodules, and it would be beneficial to users if
there was a standard README template that will enable them to understand
and access the submodule content better. Currently many of the
submodules do not have README documents, or if they do, each submodule
varies vastly regarding what content is in the document. This proposed
README template is based on the Git ReadMe structure.
Task-number: QTBUG-114809
Pick-to: 6.5
Change-Id: I3d1d1da27ed665e76ee6d1df8a93c3e5a920b0a3
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Amir Masoud Abdol <amir.abdol@qt.io>
(cherry picked from commit 80573dd36b977a5bc4a62285992890ef43f160ac)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r-- | README.md.template | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/README.md.template b/README.md.template new file mode 100644 index 00000000..0b757877 --- /dev/null +++ b/README.md.template @@ -0,0 +1,39 @@ +## Qt Package/Repository Name + +### Package Brief + +### Documentation +The documentation can be found in the following places: +* The online Qt documentation: + * [<Qt module> documentation](https://doc.qt.io/qt-6/<qtmodule>-index.html) +* Build from source: + * [Building Qt Documentation](https://wiki.qt.io/Building_Qt_Documentation) + +*Note that the documentation links in this document will always be for the +latest Qt 6 version. If you need to browse the documentation for a specific +version, you can [browse the archives](https://doc.qt.io/archives/).* + +### Build Process +Building the package/repository does depend on the Qt packages listed in dependencies.yaml. +Further dependencies to system packages are listed in the configure output. + +See the [documentation](https://doc.qt.io/qt-6/build-sources.html) for general +advice on building the Qt framework and its modules from sources. Further +information on how to build from source is also available in the +[wiki](https://wiki.qt.io/Building_Qt_6_from_Git). + +### Report an Issue +If you spot a bug, follow [these](https://doc.qt.io/qt-6/bughowto.html) +steps to report it. + +### Contribute to Qt +We welcome contributions to Qt! If you'd like to contribute, read the +[Qt Contribution Guidelines](https://wiki.qt.io/Qt_Contribution_Guidelines). + +### Licensing +Qt is available under various licenses. For details, check out the +[license documentation](https://doc.qt.io/qt-6/licensing.html). + +*Note that this README.md.template serves as a guideline for README.md files, +and that further sections can be added to individual README.md files if +necessary.* |