# Plea to package developers regarding documentation!

**URL:** <https://discourse.julialang.org/t/plea-to-package-developers-regarding-documentation/37473>\
**Category:** Community\
**Tags:** documenter\
**Created:** [April 12, 2020, 11:15pm UTC](https://discourse.julialang.org/t/plea-to-package-developers-regarding-documentation/37473 "2020-04-12T23:15:23Z")\
**Posts on this page:** 1\
**Showing post:** 6

<div class="post-metadata">

**Author:** ![tkf](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tkf/32/17635_2.png) [@tkf](https://discourse.julialang.org/u/tkf)\
**Post date:** [April 13, 2020, 4:43am UTC](https://discourse.julialang.org/t/plea-to-package-developers-regarding-documentation/37473/6 "2020-04-13T04:43:09Z")

</div>

I usually put a badge like this [![GitHub commits since tagged version](https://img.shields.io/github/commits-since/tkf/BangBang.jl/v0.3.19.svg?style=social&logo=github)](https://github.com/tkf/BangBang.jl) in README with

```julia
[![GitHub commits since tagged version](https://img.shields.io/github/commits-since/USER/PACKAGE.jl/vX.Y.Z.svg?style=social&logo=github)](https://github.com/USER/PACKAGE.jl)

```

and then use it as the docstring of the module by this one-linear

```julia
@doc read(joinpath(dirname(@ __DIR__ ), "README.md"), String) PACKAGE

```

so that the badge is included in the documentation (e.g., [https://tkf.github.io/BangBang.jl/dev/#BangBang.BangBang](https://tkf.github.io/BangBang.jl/dev/#BangBang.BangBang)). I like that it provides useful bits of information while also providing the link to the repository (though it relies on that people already know that badges are often clickable).

For fun, you can find other github-related badges in [https://shields.io/](https://shields.io/) (type `github` in the search form).

---

_[View the full topic](https://discourse.julialang.org/t/plea-to-package-developers-regarding-documentation/37473)._
