• Miguel Ojeda's avatar
    docs: rust: improve main page introducing a "Code documentation" section · b2bf463e
    Miguel Ojeda authored
    Clean the "Rust" main page by introducing a 'Code documentation" section
    to separate it from the rest of the text above.
    
    In addition, introduce the "Rust code documentation" term, which may be
    clearer than referring to a potentially unknown tool.
    
    Furthermore, for the HTML case, homogenize both `rustdoc` and
    non-`rustdoc` cases and use the term introduced above instead.
    
    Then, always generate the pregenerated version part, since now there
    is a section that is always generated and thus makes sense to do so.
    
    Finally, finish the new section with a link to more details about the
    Rust code documentation.
    
    The intention is that:
    
      - The non-HTML case mentions the code documentation too, making it
        more prominent for readers of non-HTML docs.
    
      - Both HTML cases read more naturally.
    
      - The pregenerated version is always mentioned, since it is likely
        useful for readers of non-HTML docs.
    
    Link: https://lore.kernel.org/r/20240818141200.386899-2-ojeda@kernel.orgSigned-off-by: default avatarMiguel Ojeda <ojeda@kernel.org>
    b2bf463e
index.rst 1.59 KB