--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/Use-outside-USA	Mon Nov 13 18:20:57 2023 -0800
@@ -0,0 +1,48 @@
+Themyscira Wireless system sw was written for deployment in USA, with a key goal
+of full interconnection with USA PSTN.  However, as the software grows in
+functionality and becomes more interesting, there is a growing possibility that
+someone some day may be interested in running our sw outside of USA, or outside
+of North American continent in general.  This document outlines some thoughts
+for how it might be possible to adapt the present software for use in other
+geopolitical regions.
+
+The first point that needs to be made clear is that software has no extrasensory
+psychic powers - it cannot divine where you are located in physical geography,
+and it doesn't care.  Instead the aspects which telephony software cares about
+are dialing formats and numbering plans - and in the case of Themyscira Wireless
+system sw, the "thing" to which our sw is tied is NANP, the telephone numbering
+plan of +1 country code.
+
+If anyone is contemplating the idea of running ThemWi system sw in a country
+other than USA, the first question that needs to be answered is: are you looking
+to interconnect with your country's national public telephone network similarly
+to how we (ThemWi) interconnect with USA PSTN, or are you only interested in
+running an isolated (test or toy) network without interconnection to PSTN?
+
+Interconnecting with PSTN outside of USA
+========================================
+
+Suppose that your country has SIP trunk providers who operate similarly to those
+in USA: you rent a range of numbers in your country's national telephone
+numbering plan, calls addressed to those numbers are delivered to your Internet-
+connected server via SIP, and you can likewise use SIP to dial outbound calls.
+At this point our current software will NOT work as-is - it will require
+modifications to work with the local numbering plan being some other than NANP.
+
+Please read our NANP-specifics article for the explanation of why our current
+software is tied to NANP, and in exactly what ways.  That article also gives an
+outline of what changes would need to be made to support other national
+telephone numbering plans.
+
+Running an isolated instance of Osmocom CNI + ThemWi system sw
+==============================================================
+
+If you are not interconnecting with your country's public phone network with
+real phone numbers from your country's national telephone numbering plan, then
+it doesn't matter where you are located in terms of physical geography - your
+network will be either fully isolated (self-contained) or perhaps interconnected
+with other hobbyist or community networks - but not with general PSTN.
+
+If you would like to run ThemWi system sw in such non-PSTN-connected
+configuration, the easiest way is to use fake NANP numbers - see
+Fake-NANP-numbers article (to be written) for more info.