Skip to content
This repository was archived by the owner on Apr 7, 2025. It is now read-only.

Commit 58b8d65

Browse files
committed
Moved to codeberg
1 parent 40e6803 commit 58b8d65

File tree

1 file changed

+25
-15
lines changed

1 file changed

+25
-15
lines changed

README.md

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
1-
# cargo-doc2readme ![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue) [![cargo-doc2readme on crates.io](https://img.shields.io/crates/v/cargo-doc2readme)](https://crates.io/crates/cargo-doc2readme) [![Source Code Repository](https://img.shields.io/badge/Code-On%20GitHub-blue?logo=GitHub)](https://github.com/msrd0/cargo-doc2readme) ![Rust Version: 1.61.0](https://img.shields.io/badge/rustc-1.61.0-orange.svg)
1+
# This repository has moved to <https://codeberg.org/msrd0/cargo-doc2readme>
2+
3+
# cargo-doc2readme ![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue) [![cargo-doc2readme on crates.io](https://img.shields.io/crates/v/cargo-doc2readme)](https://crates.io/crates/cargo-doc2readme) [![Source Code Repository](https://img.shields.io/badge/Code-On%20Codeberg-blue?logo=Codeberg)](https://codeberg.org/msrd0/cargo-doc2readme) ![Rust Version: 1.61.0](https://img.shields.io/badge/rustc-1.61.0-orange.svg)
24

35
`cargo doc2readme` is a cargo subcommand to create a readme file to display on
4-
[GitHub][__link0] or [crates.io][__link1],
6+
[Codeberg][__link0], [GitHub][__link1] or [crates.io][__link2],
57
containing the rustdoc comments from your code.
68

79
## Installation
@@ -14,7 +16,7 @@ yay -S cargo-doc2readme
1416

1517
On other Operating Systems, make sure you have Rust installed (using your
1618
distributions package manager, but if your package manager is garbage or you are
17-
running Windows, try [rustup][__link2]) and then run the following command:
19+
running Windows, try [rustup][__link3]) and then run the following command:
1820

1921
```bash
2022
cargo install cargo-doc2readme
@@ -31,14 +33,15 @@ cargo doc2readme
3133
This will output the readme to a file called `README.md`, using `README.j2` or the
3234
built-in template.
3335

34-
If you want to run this using GitHub Actions, you can use the pre-built docker image:
36+
If you want to run this using Forgejo or GitHub Actions, you can use the pre-built
37+
docker image:
3538

3639
```yaml
3740
readme:
3841
runs-on: ubuntu-latest
3942
steps:
40-
- uses: actions/checkout@v3
41-
- uses: docker://ghcr.io/msrd0/cargo-doc2readme
43+
- uses: actions/checkout@v4
44+
- uses: docker://codeberg.org/msrd0/cargo-doc2readme
4245
with:
4346
entrypoint: cargo
4447
args: doc2readme --check
@@ -63,11 +66,16 @@ cargo doc2readme was created. If you need a newer/nightly Rust compiler, use the
6366

6467
## Similar tools
6568

66-
[`cargo readme`][__link3] is a similar tool. However, it brings its own Rust code
69+
[`cargo readme`][__link4] is a similar tool. However, it brings its own Rust code
6770
parser that only covers the 95% use case. Also, it does not support Rust path links
68-
introduced in Rust 1.48, making your readme ugly due to GitHub showing the unsupported
69-
links as raw markdown, and being less convenient for the reader that has to search
70-
[docs.rs][__link4] instead of clicking on a link.
71+
introduced in Rust 1.48, making your readme ugly since the unsupported links are shown
72+
as raw markdown, and being less convenient for the reader that has to search [docs.rs][__link5]
73+
instead of clicking on a link.
74+
75+
[`cargo rdme`][__link6] is another tool which places your rustdoc into your readme.
76+
However, it does not come with template support, which is helpful for bigger repositories
77+
that contain multiple crates, and has only very basic support for Rust path links. All
78+
links not starting with `crate::` or `::std` are unsupported by `cargo rdme`.
7179

7280
## Stability Guarantees
7381

@@ -79,8 +87,10 @@ command-line arguments or to these stability guarantees. All other changes, incl
7987
any changes to the Rust code, or bumping the MSRV, are not considered breaking changes.
8088

8189

82-
[__link0]: https://github.com
83-
[__link1]: https://crates.io
84-
[__link2]: https://rustup.rs/
85-
[__link3]: https://github.com/livioribeiro/cargo-readme
86-
[__link4]: https://docs.rs
90+
[__link0]: https://codeberg.org
91+
[__link1]: https://github.com
92+
[__link2]: https://crates.io
93+
[__link3]: https://rustup.rs/
94+
[__link4]: https://github.com/webern/cargo-readme
95+
[__link5]: https://docs.rs
96+
[__link6]: https://github.com/orium/cargo-rdme

0 commit comments

Comments
 (0)