Kiba VS govuk-form-builder

I started https://github.com/thbar/kiba#kiba-etl to scratch my own itch & be able to write properly structured ETL jobs in Ruby. It was a blank-slate rewrite of something larger (activewarehouse-etl) which I could not maintain anymore.

This landed me not strictly a job, but long term consulting gigs with a number of companies in EU, UK & US.

The job was directly related to the project: companies wanted the expertise of data engineering & ETL, often with Kiba directly, but also in general.

This "side project" was totally worth it :-)

Definitely! As a matter of fact, this is the default data structure I use when writing Ruby ETL code (e.g. https://github.com/thbar/kiba/wiki).

Methods like "except" (https://docs.ruby-lang.org/en/3.2/Hash.html#method-i-except) or "fetch" (raising an error on missing key) are very convenient to write defensive data processing code!

Similarly, in Elixir, I use Maps a lot for the same type of jobs (https://hexdocs.pm/elixir/1.15.4/Map.html), with similar properties.

Ruby has a very cool ETL library named Kiba that fits wonderfully with Ruby's strengths.

Though it might be overkill for your problem, but have you had a look at [kiba-etl](https://github.com/thbar/kiba/blob/master/README.md)?

Kiba

If you don’t use Kiba, but work with data, check it out.

I build and maintain some libraries that are used by teams working on GOV.UK projects in Rails. Have been inundated with offers since their release, and they've gone on to be used in some fairly high profile things.

https://github.com/x-govuk/govuk-form-builder

This is my side project, I'm a dev currently contracting at DfE. This library and the form builder[0] make working with the design system easier for Rails devs.

[0] https://govuk-form-builder.netlify.app/

If you dig around on GitHub you'll see most government departments have an organisation where they publish stuff. For example, here's the MoJ, DfE, Cabinet Office.

This is definitely the best approach in my opinion, providing the people writing the docs are capable of contributing directly.

One of my projects[0] builds and deploys a static documentation site[1] on every push to master. The static site generator (Nanoc, in this case) then pulls in the library and uses it to publish its own documentation. All the examples are snippets of code[2] that are both displayed as-is and eval'd into the final output.

The guide can never be out of sync with the library.

[0] https://github.com/dfe-digital/govuk_design_system_formbuild...

[1] https://govuk-form-builder.netlify.app/

[2] https://github.com/DFE-Digital/govuk_design_system_formbuild...