From 28682b92df143f6320171ee7128e9367e22ece7d Mon Sep 17 00:00:00 2001
From: Dave Thaler <dthaler@armidalesoftware.com>
Date: Thu, 30 May 2024 10:00:09 -0700
Subject: [PATCH] Add tech faq discussion about source URLs

Fixes #174

Signed-off-by: Dave Thaler <dthaler@armidalesoftware.com>
---
 _pages/techfaqs.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/_pages/techfaqs.md b/_pages/techfaqs.md
index a412335..10ad824 100644
--- a/_pages/techfaqs.md
+++ b/_pages/techfaqs.md
@@ -334,3 +334,51 @@ unknown parties.
 Relative paths, however, are permitted in both GEDCOM and GEDZIP files and so may be more convenient to
 use in both cases.  Any tool that converts FamilySearch GEDCOM 7.0 to GEDZIP should convert local file URLs
 to relative paths within the resulting GEDZIP file.
+
+# How do I record the URL of a source?
+
+While `EVENT_DETAIL` and `REPOSITORY_RECORD` both allow a URL to be places in a `WWW` substructure,
+`SOURCE_CITATION`, `SOURCE_RECORD`, and `SOURCE_REPOSITORY_CITATION` do not.
+
+Some applications might put the source URL for an `EVENT_DETAIL` in a `WWW` substructure
+in parallel to a `SOURCE_CITATION` as follows:
+
+```
+1 DEAT
+2 DATE 14 DEC 1799
+2 WWW https://www.findagrave.com/memorial/1075
+2 SOUR @S1@
+3 PAGE Memorial: 1075
+```
+
+However, since there can be multiple source citations per event, this does not allow associating the URL
+with a specific source citation.  Instead, the URL can be placed in the `PAGE` structure with the "URL:"
+label, along with any other label: value pairs, as follows:
+
+```
+1 DEAT
+2 DATE 14 DEC 1799
+2 SOUR @FindAGraveSourceRecord@
+3 PAGE Memorial: 1075, URL: https://www.findagrave.com/memorial/1075
+```
+
+Similarly, some applications might put the source URL for a `SOURCE_RECORD` in a `PUBL` substructure
+as follows:
+
+```
+0 @S1@ SOUR
+1 TITL Grave of George Washington
+1 PUBL https://www.findagrave.com/memorial/1075
+```
+
+while others might put it in the `CALN` of a `SOURCE_REPOSITORY_CITATION` as follows:
+
+```
+0 @S1@ SOUR
+1 TITL Grave of George Washington
+1 REPO @FindAGraveRepositoryRecord@
+2 CALN https://www.findagrave.com/memorial/1075
+```
+
+Note that unlike the `PAGE` structure, the `CALN` structure has no current recommendation about using
+label: value pairs.