Minor doc improvements

Author: AlvarBer

docs/Makefile

@@ -4,7 +4,7 @@ MARKDOWN := introduction.md state_of_the_art.md workflow.md milestones.md \
 	postmortem.md  # Markdown files
 MARKDOWN_COMPLUTENSE := introduction.md focus.md state_of_the_art.md \
 	workflow.md milestones.md risk_analysis.md interface.md implementation.md \
-	type_checking.md postmortem.md
+	type_checking.md analysis.md postmortem.md
 APPENDICES := package_organization.md how.md  # Appendix after bibliography
 METADATA := metadata.yaml  # Metadata files (Author, Date, Title, etc..)
 BIBLIOGRAPHY := persimmon.bib  # BibLaTeX bibliography
@@ -42,6 +42,15 @@ complutense: $(MARKDOWN_COMPLUTENSE) $(APPENDIX) $(TEMPLATE) $(IMAGES) $(BIBLIOG
 		--metadata titlepic:images/fdi.png $(METADATA) $(MARKDOWN_COMPLUTENSE) \
 		--include-after-body $(APPENDIX) -o $(PDF)
 
+twocol: $(MARKDOWN) $(APPENDIX) $(TEMPLATE) $(IMAGES) $(BIBLIOGRAPHY) $(CSL) $(METADATA)
+	pandoc --smart --standalone --latex-engine xelatex --template $(TEMPLATE) \
+		--bibliography $(BIBLIOGRAPHY) --csl $(CSL) --table-of-contents \
+		--top-level-division chapter --metadata date:"$(shell date +%Y/%m/%d)" \
+		--metadata sansfont:"Helvetica Neue LT Com" -H table.tex \
+		--metadata classoption:'twocolumn' \
+		$(METADATA) $(MARKDOWN) --include-after-body $(APPENDIX) -o test.pdf
+
+
 # For standalone images
 images/%.pdf: graphs/%.tex
 	xelatex $< > /dev/null

docs/src/analysis.md

@@ -0,0 +1,34 @@
+Analysis
+========
+
+Raw Data
+--------
+There were 167 out of 664 malformed `.xml` files. By removing the low level
+log entries the number of malformed dropped to 12. This sessions have either a
+final high level entry that is incomplete or a single unclosed tag. The most
+appropiate procedure is to discard these.
+
+Initial
+-------
+Before performing some initial analysis on the general characteristics of the
+raw data because of the nature of the data much preprocessing is needed.
+
+The data comes as a single `.xml` file per session, they contain all the
+low-level inputs and high-level actions by the player in a chronological order.
+
+The events that best represent the flow of the game and that will be used are
+the high level ones.
+For *La Dama Boba* the set, inc, and event type tells the score of the different
+measures found on the game.
+
+There are two strategies to tackle the data, one is getting the final values
+of these measures and treat them as parameters, making it easy to collect and
+save all the sessions on a single `.csv` files.
+
+But because set events stablish a initial value and the inc, dec alter the
+value the most appropriate strategy for treating the data is to take it as a
+time series, this makes sense as there is autocorrelation between observations.
+In turn a series of additional challenges appear, such that the space between
+time measurements is not even (Although it could be transformed to do so),
+the need for a cross-validation technique that takes into account time series,
+etc...

docs/src/implementation.md

@@ -1,5 +1,6 @@
 Implementation
 ==============
+<!-- High level overview + low level overview -->
 
 
 First Iteration

docs/src/interface.md

@@ -1,8 +1,8 @@
 Interface Design
 ================
 
-Color Palette
--------------
+Colour Palette
+--------------
 
 Typography
 ----------

docs/src/milestones.md

@@ -1,12 +1,15 @@
 Milestones
 ==========
 
-
 In order to guarantee the delivery of the software a incremental software
 development has been chosen, this implies breaking down the objectives into
 smaller milestones that can be reached more easily, so in case the last
 milestone is not reached there is still a substantial product to submit.
 
+
+Tree
+----
+
 ![Milestones Tree](images/objectives.pdf)
 
 **Capped** is more than a minimum viable product, a extensive proof-of-concept,
@@ -32,6 +35,10 @@ integration that means the system would be accessible from a website interface,
 and script **synthesization**, which is the opposite of compilation, meaning
 the ability to visualize on persimmon a python source file.
 
+Gantt Diagram
+-------------
+
+
 With the settled milestones a Gantt diagram of the project development can be
 drawn.