Elixir Montréal
Let's chat on Discord: discord.gg/9ZFBvpbkkA
Join us every last Wednesday of the month to learn and share your passion for the Elixir programming language and the BEAM virtual machine. Elixir is a dynamic, functional language designed for building scalable and maintainable applications.
In a world of dependencies and online package management, documentation tools are designed and optimised around the question "how do I use your library?".
But for companies that build systems to do something, and not libraries, there is another critical question "how does the system work? how can I change it?"
Library-based documentation is inline with the code and under the same version control system.
All too often architectural documentation is outside the code and poorly kept in sync.
This talk will look at another way of thinking about documenting systems a way that keeps architectural docs in the github repo and which plays nice with ExDoc.
Gordon Guthrie has been an Erlang programmer since 2002 and an Elixir one for quite a bit less.
In a world of dependencies and online package management, documentation tools are designed and optimised around the question "how do I use your library?".
But for companies that build systems to do something, and not libraries, there is another critical question "how does the system work? how can I change it?"
Library-based documentation is inline with the code and under the same version control system.
All too often architectural documentation is outside the code and poorly kept in sync.
This talk will look at another way of thinking about documenting systems a way that keeps architectural docs in the github repo and which plays nice with ExDoc.
Gordon Guthrie has been an Erlang programmer since 2002 and an Elixir one for quite a bit less.
Elixir Montréal
Let's chat on Discord: discord.gg/9ZFBvpbkkA
Join us every last Wednesday of the month to learn and share your passion for the Elixir programming language and the BEAM virtual machine. Elixir is a dynamic, functional language designed for building scalable and maintainable applications.
In a world of dependencies and online package management, documentation tools are designed and optimised around the question "how do I use your library?".
But for companies that build systems to do something, and not libraries, there is another critical question "how does the system work? how can I change it?"
Library-based documentation is inline with the code and under the same version control system.
All too often architectural documentation is outside the code and poorly kept in sync.
This talk will look at another way of thinking about documenting systems a way that keeps architectural docs in the github repo and which plays nice with ExDoc.
Gordon Guthrie has been an Erlang programmer since 2002 and an Elixir one for quite a bit less.
In a world of dependencies and online package management, documentation tools are designed and optimised around the question "how do I use your library?".
But for companies that build systems to do something, and not libraries, there is another critical question "how does the system work? how can I change it?"
Library-based documentation is inline with the code and under the same version control system.
All too often architectural documentation is outside the code and poorly kept in sync.
This talk will look at another way of thinking about documenting systems a way that keeps architectural docs in the github repo and which plays nice with ExDoc.
Gordon Guthrie has been an Erlang programmer since 2002 and an Elixir one for quite a bit less.
Get in touch!
hi@guild.host