Skip to content

Commit 687a7e4

Browse files
committed
added doc notes
1 parent a155955 commit 687a7e4

File tree

3 files changed

+18
-7
lines changed

3 files changed

+18
-7
lines changed

docs/REAMDE.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
## Building the documentation
2+
3+
1. Enable XML documentation generation in Visual Studio project settings
4+
2. Build the project
5+
3. Run the markdown generator script and put files in docs/wiki/Generated folder `python xml2md.py /path/to/docs.xml wiki/Generated`
6+
7+
## Notes
8+
9+
* Documentation is posted on the [Wiki](https://github.com/jackbrookes/unity-experiment-framework/wiki)
10+
* The python script requires [markdown-generator](https://github.com/cmccandless/markdown-generator) to run (`pip install markdown-generator`)
11+

docs/wiki

Submodule wiki updated from 93438bf to b14a1f3

docs/xml2md.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -92,20 +92,20 @@ def to_md(self, directory):
9292
blockquote.append(summary_from_member(method))
9393
blockquote.append("")
9494
blockquote.append(mg.strong("Parameters"))
95-
writer.write(blockquote)
95+
blockquote.append("")
9696
params = [p for p in method if p.tag == "param"]
9797

98-
blockquote2 = mg.BlockQuote(level=2)
98+
pre = "* "
9999
if len(params) == 0:
100-
blockquote2.append(mg.emphasis("None"))
100+
blockquote.append(mg.emphasis("None"))
101101
else:
102102
for param in params:
103103
param_name = param.attrib["name"]
104104
param_text = param.text if param.text is not None else ""
105-
blockquote2.append(inline_code(
105+
blockquote.append(pre + inline_code(
106106
param_name) + ": " + param_text)
107-
blockquote2.append("")
108-
writer.write(blockquote2)
107+
blockquote.append("")
108+
writer.write(blockquote)
109109

110110

111111
writer.write_hrule()

0 commit comments

Comments
 (0)