doc: Rework the publishing process

Author: noraj

docs/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [Unreleased]
+
+- Documentation:
+  - Rework the publishing process
+
 ## [3.1.0]
 
 Additions:

docs/pages/publishing.md

@@ -1,63 +1,56 @@
 # Publishing
 
-## On Rubygems.org
+Change version in `lib/tls_map/version.rb`.
 
-```plaintext
-$ git tag -a vx.x.x
-$ git push --follow-tags
-$ gem push tls-map-x.x.x.gem
-```
-
-See https://guides.rubygems.org/publishing/.
+Be sure all tests pass!
 
-On new release don't forget to rebuild the library documentation:
-
-```plaintext
-$ bundle exec yard doc
+```bash
+bundle exec rake test
 ```
 
-And to be sure all tests pass!
+Ensure there is no linting offence.
 
-```plaintext
-$ bundle exec rake test
+```bash
+bundle exec rubocop
 ```
 
-## On BlackArch
+Update `data/mapping.marshal` and `data/extended.marshal`:
 
-BA process
+```bash
+bundle exec ruby -Ilib -rtls_map bin/tls-map update --with-extended
+```
 
-On new release don't forget to rebuild the library documentation:
+Update `INTEGRITY` of `TLSmap::CLI` and `TLSmap::CLI::Extended` in `lib/tls_map/cli/cli.rb`.
 
-```plaintext
-$ bundle exec yard doc
+```bash
+sha256sum data/*.marshal
 ```
 
-And to be sure all tests pass!
+Update other files:
 
-```plaintext
-$ bundle exec rake test
+```bash
+bundle exec ruby -Ilib -rtls_map bin/tls-map export data/mapping.json json_pretty
+bundle exec ruby -Ilib -rtls_map bin/tls-map export data/mapping.min.json json_compact
+bundle exec ruby -Ilib -rtls_map bin/tls-map export data/mapping.md markdown
 ```
 
-## Update data
+Update the table in `docs/pages/mapping.md`.
 
-Update `data/mapping.marshal` and `data/extended.marshal`:
+Don't forget to rebuild the library documentation:
 
+```bash
+bundle exec yard doc
 ```
-$ bundle exec ruby -Ilib -rtls_map bin/tls-map update --with-extended
-```
-
-Update `INTEGRITY` of `TLSmap::CLI` and `TLSmap::CLI::Extended` in `lib/tls_map/cli/cli.rb`.
 
-```
-$ sha256sum data/*.marshal
-```
+Push git tag and the gem on Rubygems.
 
-Update other files:
+```bash
+git tag -a vx.x.x
+git push --follow-tags
 
-```
-$ bundle exec ruby -Ilib -rtls_map bin/tls-map export data/mapping.json json_pretty
-$ bundle exec ruby -Ilib -rtls_map bin/tls-map export data/mapping.min.json json_compact
-$ bundle exec ruby -Ilib -rtls_map bin/tls-map export data/mapping.md markdown
+bundle exec rake build
+gem push tls-map-x.x.x.gem
 ```
 
-Update the table in `docs/pages/mapping.md`.
+See https://guides.rubygems.org/publishing/.
+