source4/setup/adprep/README.txt

   1 The following files in the WindowsServerDocs folder have been sourced from a
   2 Microsoft Github repository.
   3
   4 project: https://github.com/MicrosoftDocs/windowsserverdocs/
   5
   6 License files (LICENSE and LICENSE-CODE) have also been included in the
   7 ./WindowsServerDocs directory for reference.
   8
   9
  10 ===============================================================================
  11
  12 The Schema updates file is taken from this repository:
  13
  14 file: WindowsServerDocs/identity/ad-ds/deploy/Schema-Updates.md
  15
  16 ./WindowsServerDocs/Schema-Updates.md is our current version of the file
  17 (last updated Jun 1, 2017, commit SHA f79755b75d2810b8a4).
  18
  19 The ms_schema_markdown.py script was then used to produce the .ldf files.
  20
  21 However, this schema didn't work. The ./WindowsServerDocs/*.diff files are the
  22 changes we made on top of this to get the schema working on Samba. If you are
  23 re-generating the .ldf files, to apply the patches, use:
  24
  25 for p in `ls WindowsServerDocs/*.diff` ; do patch -p 1 < $p ; done
  26
  27 All this is handled at runtime in the provision code, so that we do
  28 not store patched generated files in git (an alternative would have
  29 been to patch the original markdown).
  30
  31
  32 ===============================================================================
  33
  34 The Forest Wide updates file is taken from this repository:
  35
  36 file: WindowsServerDocs/identity/ad-ds/deploy/RODC/Forest-Wide-Updates.md
  37
  38 ./WindowsServerDocs/Forest-Wide-Updates.md is our current version of the file
  39 (last updated Dec 15, 2017, commit SHA f209fb9101ee87107).
  40
  41 The ms_forest_updates_markdown.py script is used to extract the add portions of
  42 the updates. The rest are handled manually in forest_updates.py by interpreting
  43 this documentation (as they are not as well-structured).