Difference between revisions of "Project template"
Line 7: | Line 7: | ||
Latest development version: 0.1.0. | Latest development version: 0.1.0. | ||
− | See [[# | + | See [[#TODO|TODO]] for work that still needs to be done. |
= Motivation = | = Motivation = | ||
Line 29: | Line 29: | ||
== Copyright == | == Copyright == | ||
− | Copyright © | + | Copyright © 2020, [[#Contributors|Contributors]]. |
== License == | == License == | ||
Line 87: | Line 87: | ||
If you're looking to set up a development environment for this project here's what you need to know: | If you're looking to set up a development environment for this project here's what you need to know: | ||
− | = | + | Send your patch to [mailto:jj5@progclub.org?subject=pcproject jj5@progclub.org] along with a statement that you are willing to be listed in the [[#Contributors|contributors]] section of the documentation and willing to license your contribution under the [[#License|license]]. |
− | + | == Notes for administrators == | |
− | + | To release a version of this project use the software itself. | |
− | + | First, run maintenance and commit any changes: | |
− | $ | + | $ <code>svnman commit</code> |
− | |||
− | |||
− | + | Then run the release: | |
− | + | $ <code>bin/dev/release.sh</code> | |
− | + | You will be prompted to update the project documentation. | |
− | + | = Generated documentation = | |
− | |||
− | |||
− | |||
− | == | ||
− | |||
− | |||
− | |||
− |
Revision as of 16:23, 2 March 2020
{project name} is the ProgClub {project's purpose} software. That's the software that {does what the project does}. It's a fork of {whatever you've copied} with {whatever you've added}. For other projects see projects.
Status
We use semantic versioning. Latest production version: unreleased. Latest development version: 0.1.0.
See TODO for work that still needs to be done.
Motivation
Why this software?
Administration
Contributors
Members who have contributed to this project. Newest on top.
All contributors have agreed to the terms of the Contributor License Agreement. This excludes any upstream contributors who tend to have different administrative frameworks.
Upstream contributors:
- {link to project's upstream contributors, or delete this section}
Copyright
Copyright © 2020, Contributors.
License
Licensed under the {New BSD license, MIT license, GPL, or link to license file}.
Components
Libraries, tools, services or media from third parties used under license:
- TODO: list 'em
Resources
Downloads
TODO: link to downloads or explain why there aren't any.
Source code
The repository can be browsed online:
https://www.progclub.org/pcrepo/pcproject/branches/0.1
The latest stable released version of the code is available from:
https://www.progclub.org/svn/pcrepo/pcproject/tags/latest/0.1
Or if you want the latest version for development purposes:
https://www.progclub.org/svn/pcrepo/pcproject/branches/0.1
Links
- add links here, put them in sections if that's appropriate
Specifications
Functional specification
The functional specification describes what the project does.
Technical specification
The technical specification describes how the project works.
Notes
See versioning for information on our semantic version numbers.
Notes for implementers
If you are interested in incorporating this software into your project, here's what you need to know:
Notes for developers
If you're looking to set up a development environment for this project here's what you need to know:
Send your patch to jj5@progclub.org along with a statement that you are willing to be listed in the contributors section of the documentation and willing to license your contribution under the license.
Notes for administrators
To release a version of this project use the software itself.
First, run maintenance and commit any changes:
$ svnman commit
Then run the release:
$ bin/dev/release.sh
You will be prompted to update the project documentation.