Skip to content

Raku, Perl and Clojure reference pages lack the directory table, member order and links of other ports #318

Closed

Description

@tony

Summary

The Raku, Perl and Clojure reference pages fall short of the other ports in four ways. Raku's server page orders its members poorly and leaves most method names in its description unlinked. Perl's description puts no space between a code block and the next heading. None of the three shows the capability directory ("What is on here") table.

Reproduction

  1. Open https://libtmux.org/en/raku/latest/reference/libtmux-server/ and read the sidebar under Server and the Description.
  2. Open https://libtmux.org/en/perl/latest/reference/libtmux-server/ and look at SYNOPSIS and the CONTRACT heading under it.
  3. Open https://libtmux.org/en/clojure/latest/reference/libtmux-core-open/.
  4. Compare https://libtmux.org/en/rs/latest/reference/server-server/ and https://libtmux.org/en/julia/latest/reference/libtmux-server/.

Expected

  • Raku's members lead with what a reader needs, as other ports' do, with each -async twin beside its synchronous method.
  • `start`, `attach`, `snapshot`, `run-batch` and `from-env` link to their LibTmux::Server members.
  • Perl's code block has the same gap below it as other pages.
  • Raku, Perl and Clojure server pages show the directory table.

Actual

References

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions