确保您的源代码托管在使用其中一个版本控制系统公开访问的存储库中（Github、Bitbucket、GitLab实例、机构软件伪造等）受Software Heritage支持目前为Subversion、Mercurial和Git。以下成熟的最佳实践，在源代码树的顶层包含以下文件：

• 自述文件
  包含软件描述（名称、用途、网站指针、文档、开发平台、联系人和支持信息…）
• 作者
  需要为软件记入贷方的所有人员的列表；如果您想指定每个人的角色，我们建议使用Inria阐述的贡献者分类.
• 许可证
  项目许可条款。对于开源许可证，请使用标准SPDX许可证名称.
• A类代码元.json
  链接的数据元数据文件将有助于在Software Heritage存档中为源代码编制索引，并提供链接到其他相关研究输出的简单方法。请参阅代码元更多信息和我们的CodeMeta生成器工具。

正确准备好代码存储库并更新后，您需要：

• 转到Software Heritage立即保存代码页面,
• 在下拉列表中选择您的版本控制系统，
• 输入代码存储库url（开发平台提供的克隆/签出url），
• 单击“提交”按钮。

就这样，一切都结束了！无需创建帐户或提供任何类型的个人信息。如果您提供的url正确，Software Heritage将在不久后存档您的存储库及其完整的开发历史。如果您的存储库位于我们已知的一个主要伪造品上，则此过程只需几个小时；如果您指向我们以前从未见过的位置，可能需要更长的时间，因为我们需要手动批准它。请注意，您也可以使用专用软件遗产API入口点.

源代码归档后，有很多方法可以在文章中引用它。三种常见的用例是

• 将链接添加到完整存储库在Software Heritage中存档
• 将链接添加到软件项目的精确版本
• 将链接添加到源代码文件的精确版本，一直到代码行的级别。

完整存储库

通过在用于请求存档的URL前面加上前缀，可以获得到Software Heritage中存档的完整存储库（及其所有开发历史）的链接https://archive.softwareheritage.org/browse/origin。例如，如果您保存的存储库是https://github.com/rdicomoso/parmap，则指向Software Heritage中保存的版本的链接将为

https://archive.softwareheritage.org/browse/origin/https://github.com/rdicomoso/parmap/

通过此链接，您的读者可以广泛浏览存储库的内容深入研究其开发历史和/或目录结构，直至每个文件。

项目的具体版本

软件遗产提供了完全文档化的标准标识符模式，已调用SWH-ID软件，用于指向精确版本它存档的所有源代码。例如，以下SWH-ID标识精确版本关于Parmap的源代码：

swh:1：修订版：0064fbd0ad69de205ea6ec6999f3d3895e9442c2；原产地=https://github.com/rdicomoso/parmap;

SWH-ID可以通过在其前面添加前缀来转换为可点击的URLhttps://archive.softwareheritage.org/。因此，以下（超）链接将您直接带到Software Heritage中的一个页面，该页面正在浏览精确的版本（试试看！）

https://archive.softwareheritage.org/swh:1:rev:0064fbd0ad69de205ea6ec6999f3d3895e9442c2;原产地=https://github.com/rdicomoso/parmap

获得正确SWH-ID的一个非常简单的方法是浏览Software Heritage中存档的代码，并导航到您感兴趣的修订版。然后单击永久链接垂直红色标签它出现在存档的所有页面上，在打开的选项卡中选择修订标识符。 

SWH-ID的版本1使用git-compatible散列，因此，如果您使用git作为版本控制系统，则只需在前面加上前缀即可创建正确的SWH-IDswh:1：转速：到提交哈希。

代码片段

Software Heritage支持的SWH-ID允许您更进一步，通过使用行=限定符可用于指向文件的标识符。例如，以下SWH-ID指向Parmap源代码中的核心映射算法，如2012年描述Parmap的一篇研究文章所示：

swh:1:cnt:d5214ff9562a1fe78db51944506ba48c20de3379；原产地=https://github.com/rdicomoso/parmap;线路=101-143

点击进行测试这个链接：您将被无缝地带到Software Heritage存档中的一个页面上，该页面显示了相应的源代码，并突出显示了相关行。在这里，您也可以通过导航到您对存档感兴趣的代码片段，单击片段第一行的行号，按住shift键并单击最后一行，然后打开permalinks选项卡来获得准确的链接