aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSafiyyah Moosa <safiyyah.moosa@qt.io>2023-08-15 10:50:26 +0200
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2023-09-23 09:02:59 +0000
commit9e6717ed6b4a6cd6f770c730b2b36f461e123219 (patch)
treef58c3697c1947a3389de02bcc0c3d4f11527a521
parent98b3ee4067520196586fdf4fc4e8b73eccd0a8e0 (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.template39
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.*