1) Converting documents like design documents, test plans, installation manuals, and operation manuals into code allows them to be tested and run automatically, improving reliability. 2) Reliability is improved because code is less prone to human error than documents and can be run repeatedly through testing and continuous integration environments. 3) Changing documents to code improves the reliability of products, operations, and the documents themselves by making their instructions executable and verifiable.

1. From Document to Code.
@koduki
Jan 15, 2014

2. What dose “From Document to Code”
mean?
Detail desigin document and Test Document => Auto Test framework
• JUnit/rspec
• Selenium/Cucumber
• serverspec
Install Manual => provisioning tool
• chef/puppet
Operation Manual => deployment tool, CI tool
• Capystrano
• Fabric
• Jenkins

3. Why do we have to change into code
from document?
• Cost reduction ?
• Do we have to do it for opeation cost ?

4. Why do we have to change into code
from document?
Not only cost !

5. Why do we have to change into code
from document?
Reliability

6. What is reliability ?
Two reliabilities
• reliability of document
• reliability of operation
• reliability of document

7. What is reliability of product ?
Code reliability
• Testing tool make easy to do regration test.
• Regration test is standard method for preventing degrade.
• If you do it by manual, you will exhaust very much time.

8. What is reliability of operation ?
• Human sometimes makes a mistake.
• If it dose again and again, risks increase.
• Program dose not a mistake, if code is correct.

9. What is reliability of document ?
•
•
•
•
•
•
•
In many case, maintenance of document is difficult.
It sometimes is not corrected.
Because document dose not been ran repeatedly.
Code is very easy to run repeatedly.
Especialy CI environment.
We can belive code, because code is running.
This is very important.

10. Conclusion
•
•
•
•
•
“From Document to Code” is not only cost.
Reliability of product.
Reliability of operation.
Reliability of document.
Let’s change from document to code!