Create these files

For getting started purposes only

Give example files for: NOTICE.txt, CHANGES.rst, and doc?/conf.py snippet

NOTICE.txt

Copyright (C) 2023-2024 Dave Faulkmore

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

What gets updated?

Copyright end year

Copyright start year is specified in pyproject.toml

Sphinx doc?/conf.py

Sphinx are either in:

• doc/conf.py

or

• docs/conf.py

Contains block

# @@@ editable vampire_smoothie_machines
copyright = "2023–2024, Dave Faulkmore"
# The short X.Y.Z version.
version = "0.0.1"
# The full version, including alpha/beta/rc tags.
release = "0.0.1"
# The date of release, in "monthname day, year" format.
release_date = "April 25, 2024"
# @@@ end

Can start out the block as

Without a snippet_co

# @@@ editable
# @@@ end

or with a snippet_co

# @@@ editable vampire_smoothie_machines
# @@@ end

And the block will be filled in by these commands

More than one snippet (in Sphinx doc?/conf.py)

drain-swamp seed
drain-swamp edits --kind="0.0.1" --snip="vampire_smoothie_machines"

Only one snippet; snippet_co will be automatically inferred

drain-swamp seed
drain-swamp edits --kind="0.0.1"

CHANGES.rst

This is skeleton change log

.. this will be appended to README.rst

Changelog
=========

..

   Feature request
   .................

   Known regressions
   ..................

   Commit items for NEXT VERSION
   ..............................

.. scriv-start-here

.. scriv-end-here