docu Flashcards

1
Q

what is the workflow for creating customer docu

A

copy PROJECT-SPECIFIC-DATA_copyMeAndRemoveThisSuffix to project directory and remove Suffix
copy DOCU.tex into your docu folder
parse gui configs through python ~/docu/gui-config-to-tex “gui cfg” “OPERATING RECALSYS.tex”
open docu.tex
get rid of all yellow
create customer branch and extensions if necessary
run ~/docu/finalize
bring extensions to master

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
2
Q

what is the workflow for adding custom changes to the documentation?

A
  • check, what file the changes need to be made in
  • check how this file is loaded into the documentation -> 2 possibilities
    1. \inputCellTypeSpecificWithFallback -> copy file from ~/docu to project directory
    2. normally -> create new ~/docu working branch
    -> create flag for new changes -> ensure backward compatibility through use of \inputCellTypeSpecificWithFallback, \withDefault etc. if possible
How well did you know this?
1
Not at all
2
3
4
5
Perfectly
3
Q

What is the name of the LaTeX function, that loads a file from project directory if it exists there, and if not loads it from ~/docu?

A

\inputCellTypeSpecificWithFallback

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
4
Q

For the customer documentation, which files lie in ~/docu and which in the project directory?

A

all custom files in project directory, all others in ~/docu

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
5
Q

Which files shall be customized and which not in the customer docu?

A

all ALL_CAPS files are meant to be customized.
Also check Wiki for the exact list

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
6
Q

what does one have to do when adding a new define to the docu to ensure backward compatibility?

A

/withdefautl{name}

How well did you know this?
1
Not at all
2
3
4
5
Perfectly