1 files changed, 43 insertions, 0 deletions
diff --git a/source4/setup/adprep/README.txt b/source4/setup/adprep/README.txt
new file mode 100644
index 0000000..3f6c187
--- /dev/null
+++ b/source4/setup/adprep/README.txt
@@ -0,0 +1,43 @@
+The following files in the WindowsServerDocs folder have been sourced from a
+Microsoft Github repository.
+
+project: https://github.com/MicrosoftDocs/windowsserverdocs/
+
+License files (LICENSE and LICENSE-CODE) have also been included in the
+./WindowsServerDocs directory for reference.
+
+
+===============================================================================
+
+The Schema updates file is taken from this repository:
+
+file: WindowsServerDocs/identity/ad-ds/deploy/Schema-Updates.md
+
+./WindowsServerDocs/Schema-Updates.md is our current version of the file
+(last updated Jun 1, 2017, commit SHA f79755b75d2810b8a4).
+
+The ms_schema_markdown.py script was then used to produce the .ldf files.
+
+However, this schema didn't work. The ./WindowsServerDocs/*.diff files are the
+changes we made on top of this to get the schema working on Samba. If you are
+re-generating the .ldf files, to apply the patches, use:
+
+for p in `ls WindowsServerDocs/*.diff` ; do patch -p 1 < $p ; done
+
+All this is handled at runtime in the provision code, so that we do
+not store patched generated files in git (an alternative would have
+been to patch the original markdown).
+
+
+===============================================================================
+
+The Forest Wide updates file is taken from this repository:
+
+file: WindowsServerDocs/identity/ad-ds/deploy/RODC/Forest-Wide-Updates.md
+
+./WindowsServerDocs/Forest-Wide-Updates.md is our current version of the file
+(last updated Dec 15, 2017, commit SHA f209fb9101ee87107).
+
+The ms_forest_updates_markdown.py script is used to extract the add portions of
+the updates. The rest are handled manually in forest_updates.py by interpreting
+this documentation (as they are not as well-structured).