For the benefit of search engines we should add to all files:
<!-- SPDX-ArtifactOfProjectName: LumoSQL -->
As distinct from the Copyright tag ("2019 The LumoSQL Authors") there are good reasons to identify the original author of every file. Git tracks all the authors, but the original is special, so we should add this as a form a meta-meta data:
<!-- SPDX-FileComment: Original by Yasmin McGootchie, 2020 -->
For source code, not documentation, we should also add SPDX-FileName, for example:
SPDX-FileName: lmdb-backend/src/btree.c
The reason for not using SPDX-FileName for documentation is that it needs to be possible to trivially rename a doc file without having to remember to update the metadata.
At present source files have two SPDX lines eg:
And documentation files have three SPDX lines:
For the benefit of search engines we should add to all files:
As distinct from the Copyright tag ("2019 The LumoSQL Authors") there are good reasons to identify the original author of every file. Git tracks all the authors, but the original is special, so we should add this as a form a meta-meta data:
For source code, not documentation, we should also add SPDX-FileName, for example:
The reason for not using SPDX-FileName for documentation is that it needs to be possible to trivially rename a doc file without having to remember to update the metadata.