# New pkg.julialang.org

**URL:** <https://discourse.julialang.org/t/new-pkg-julialang-org/22622>\
**Category:** Community\
**Tags:** announcement\
**Created:** [April 2, 2019, 1:24am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622 "2019-04-02T01:24:18Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![StefanKarpinski](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/stefankarpinski/32/24_2.png) [@StefanKarpinski](https://discourse.julialang.org/u/StefanKarpinski)\
**Post date:** [April 2, 2019, 1:24am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/1 "2019-04-02T01:24:18Z")

</div>

I’m happy to announce a brand new [https://pkg.julialang.org](https://pkg.julialang.org) site. You can search for packages by name and topic (topics are populated from GitHub) and view the docs for all registered packages in one central place. In the near future it will also have full documentation of all packages and regex code search.

We hope that this service will not only help Julia users discover great packages more easily, but also make it a little simpler to develop and publish those packages. It removes the burden from package developers of figuring out how to host docs and provide search functionality. The service is based on [DocumentationGenerator.jl](https://github.com/JuliaDocs/DocumentationGenerator.jl) and has been the result of the efforts of many people, including @pfitzseb, @Venkatesh_D (both at [Julia Computing](https://juliacomputing.com)) and @sdanisch (at NextJournal). Major thanks to all who have contributed!

The package doc & search service is part of the [JuliaTeam Vision](https://juliacomputing.com/blog/2019/02/13/JuliaTeam-Vision.html) and is one of the services that Julia Computing is developing, hosting and maintaining to support the open source ecosystem. The service is also available as part of the JuliaTeam product for organizations that want to have centralized package doc & search for their private Julia packages.

Testing and feedback welcomed!

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [April 2, 2019, 1:35am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/2 "2019-04-02T01:35:03Z")

</div>

Great news! Thank you all! 👏 🎆

I am curious how tags work? What are the steps that package authors should follow to have their packages listed under the “statistics” tag for example?

---

<div class="post-metadata">

**Author:** ![avik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/avik/32/17_2.png) [@avik](https://discourse.julialang.org/u/avik)\
**Post date:** [April 2, 2019, 1:36am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/3 "2019-04-02T01:36:50Z")

</div>

These are tags that you add on the github project page.

---

<div class="post-metadata">

**Author:** ![ChrisRackauckas](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/chrisrackauckas/32/77_2.png) [@ChrisRackauckas](https://discourse.julialang.org/u/ChrisRackauckas)\
**Post date:** [April 2, 2019, 1:39am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/4 "2019-04-02T01:39:48Z")

</div>

The link for the DiffEq docs seem to be broken, pointing to some alternative site? I am curious if there is something we need to set for this to know where the docs are at.

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [April 2, 2019, 1:41am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/5 "2019-04-02T01:41:04Z")

</div>

I have the tag `statistics` in [GeoStats.jl](https://github.com/juliohm/GeoStats.jl) for example but it doesn’t show up. Appreciate your advise.

---

<div class="post-metadata">

**Author:** ![StefanKarpinski](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/stefankarpinski/32/24_2.png) [@StefanKarpinski](https://discourse.julialang.org/u/StefanKarpinski)\
**Post date:** [April 2, 2019, 2:12am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/6 "2019-04-02T02:12:14Z")

</div>

The GeoStats package doesn’t seem to show up at all. Perhaps the doc build failed?

---

<div class="post-metadata">

**Author:** ![Mattriks](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mattriks/32/351_2.png) [@Mattriks](https://discourse.julialang.org/u/Mattriks)\
**Post date:** [April 2, 2019, 2:18am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/7 "2019-04-02T02:18:58Z")

</div>

I checked the [docs for Gadfly](https://pkg.julialang.org/docs/Gadfly/DvECm/1.0.1/gallery/geometries/) and a lot of plots don’t show e.g. the plots that use `RDatasets`. `RDatasets` is not a Gadfly requirement, but it is a [requirement for building the docs](https://github.com/GiovineItalia/Gadfly.jl/blob/master/docs/Project.toml).

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [April 2, 2019, 2:22am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/8 "2019-04-02T02:22:37Z")

</div>

I am building the docs on a separate process on Travis, would that be an issue? [https://github.com/juliohm/GeoStats.jl/blob/master/.travis.yml#L17-L26](https://github.com/juliohm/GeoStats.jl/blob/master/.travis.yml#L17-L26)

---

<div class="post-metadata">

**Author:** ![StefanKarpinski](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/stefankarpinski/32/24_2.png) [@StefanKarpinski](https://discourse.julialang.org/u/StefanKarpinski)\
**Post date:** [April 2, 2019, 2:25am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/9 "2019-04-02T02:25:28Z")

</div>

Possibly. Anything non-standard might cause problems. Will look into it.

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [April 2, 2019, 2:50am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/10 "2019-04-02T02:50:59Z")

</div>

As a side question, please let me know if there is a better way of building documentation in Julia packages. I like the Travis job approach because AFAIK it is performed in parallel.

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [April 2, 2019, 6:03am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/11 "2019-04-02T06:03:06Z")

</div>

> [@StefanKarpinski](#):
>
> It removes the burden from package developers of figuring out how to host docs and provide search functionality.

How does this work, ie what should the package authors do for this to work? Just have the docs in `docs`? Does this mean that we don’t need to generate and deploy docs any more?

Also, DynamicHMC.jl is not showing up for some reason, while my other packages are there.

---

<div class="post-metadata">

**Author:** ![thofma](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/thofma/32/1691_2.png) [@thofma](https://discourse.julialang.org/u/thofma)\
**Post date:** [April 2, 2019, 6:39am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/12 "2019-04-02T06:39:45Z")

</div>

[https://github.com/thofma/Hecke.jl](https://github.com/thofma/Hecke.jl) is not showing up. I am building the docs similar to @juliohm in the “new way” as described in [PSA: Use a project for building your docs](https://discourse.julialang.org/t/psa-use-a-project-for-building-your-docs/14974).

---

<div class="post-metadata">

**Author:** ![baggepinnen](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/baggepinnen/32/693_2.png) [@baggepinnen](https://discourse.julialang.org/u/baggepinnen)\
**Post date:** [April 2, 2019, 7:06am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/13 "2019-04-02T07:06:57Z")

</div>

It seems that the documentation link defaults to something built from the package readme. This sounds like a good fallback, but in many cases the package has a native documentation that perhaps would be better to link to. I noticed that the native documentation is indeed linked in some cases, but not all. Can one edit this link manually somehow?

---

<div class="post-metadata">

**Author:** ![Datseris](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/datseris/32/13406_2.png) [@Datseris](https://discourse.julialang.org/u/Datseris)\
**Post date:** [April 2, 2019, 7:54am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/14 "2019-04-02T07:54:52Z")

</div>

The website seems excellent! I am very happy that one can search by tags, this makes perfect sense and seems to work! Hopefully this will make finding Julia packages easier for new users. We now all have to take good care to choose proper and plentyful github tags to help everyone!

I also appreciate the attempt at “automatic generation” of documentation, but it may backfire… Most packages built their own docs which has nothing to do with the `README` file. Wouldn’t it better to just link the documentation page instead of automatically generating something? README files have a “docs” badge, you can use this to automate the process.

For example, Finding DynamicalSystems.jl and clicking [documentation](https://pkg.julialang.org/docs/DynamicalSystems/TY1vN/1.2.0/) just shows a rendering of the README and then has a long list of failed docstrings. This just gives the impression of non-professional documentation. I’d certainly like to avoid this given the absurd amount of time I’ve spent making the [true documentation](https://juliadynamics.github.io/DynamicalSystems.jl/dev/) as professional as possible.

---

<div class="post-metadata">

**Author:** ![pfitzseb](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/pfitzseb/32/45566_2.png) [@pfitzseb](https://discourse.julialang.org/u/pfitzseb)\
**Post date:** [April 2, 2019, 8:25am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/15 "2019-04-02T08:25:56Z")

</div>

So the longer term plan here is to allow you to [specify what you want us to do](https://github.com/JuliaLang/Pkg.jl/issues/1070):

1. By default, we build whatever you have in `docs/make.jl` or fall back to your `README`, but you can also
2. give us a repo/branch where we can find your docs so we can build those, or
3. give us an URL with the built docs we can link to.

I _think_ those options should cover every eventuality, but let me know if not.

> [@ChrisRackauckas](#):
>
> The link for the DiffEq docs seem to be broken, pointing to some alternative site? I am curious if there is something we need to set for this to know where the docs are at.

This is another reason we need the above implemented – many big packages/orgs (DiffEq, Juno, etc.pp.) have their docs set up in a different repo which we can’t find right now.

> [@Tamas\_Papp](#):
>
> How does this work, ie what should the package authors do for this to work? Just have the docs in `docs` ? Does this mean that we don’t need to generate and deploy docs any more?

Unless you have special requirements (e.g. you need a special travis setup or whatever) then that should be enough, yes.

> [@Datseris](#):
>
> I also appreciate the attempt at “automatic generation” of documentation, but it may backfire… Most packages built their own docs which has nothing to do with the `README` file. Wouldn’t it better to just link the documentation page instead of automatically generating something? README files have a “docs” badge, you can use this to automate the process.
> 
> For example, Finding DynamicalSystems.jl and clicking [documentation](https://pkg.julialang.org/docs/DynamicalSystems/TY1vN/1.2.0/) just shows a rendering of the README and then has a long list of failed docstrings. This just gives the impression of non-professional documentation. I’d certainly like to avoid this given the absurd amount of time I’ve spent making the [true documentation](https://juliadynamics.github.io/DynamicalSystems.jl/dev/) as professional as possible.

That’s a fair point. The options outlined above should address it though, I think. Maybe we should also make it more obvious when the docs are autogenerated.

---

<div class="post-metadata">

**Author:** ![Datseris](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/datseris/32/13406_2.png) [@Datseris](https://discourse.julialang.org/u/Datseris)\
**Post date:** [April 2, 2019, 8:32am UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/16 "2019-04-02T08:32:48Z")

</div>

Thanks Seb, this sounds fair and square and indeed should cover everything. Please share with us where we can submit this doc link corresponding to point 3. (when it is ready)

---

<div class="post-metadata">

**Author:** ![Venkatesh\_D](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/venkatesh_d/32/7760_2.png) [@Venkatesh\_D](https://discourse.julialang.org/u/Venkatesh_D)\
**Post date:** [April 2, 2019, 2:02pm UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/17 "2019-04-02T14:02:09Z")

</div>

It is available now

---

<div class="post-metadata">

**Author:** ![StefanKarpinski](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/stefankarpinski/32/24_2.png) [@StefanKarpinski](https://discourse.julialang.org/u/StefanKarpinski)\
**Post date:** [April 2, 2019, 2:14pm UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/18 "2019-04-02T14:14:26Z")

</div>

If people could please file issues at [GitHub - JuliaDocs/DocumentationGenerator.jl](https://github.com/JuliaDocs/DocumentationGenerator.jl) that would be super helpful. We’ll be paying attention to the repo, responding there and fixing issues as they come up.

---

<div class="post-metadata">

**Author:** ![ExpandingMan](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/expandingman/32/866_2.png) [@ExpandingMan](https://discourse.julialang.org/u/ExpandingMan)\
**Post date:** [April 2, 2019, 2:22pm UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/19 "2019-04-02T14:22:23Z")

</div>

It would be nice if the “Explore Packages” link in [julialang.org](http://julialang.org) linked to [pkg.julialang.org](http://pkg.julialang.org). I apologize if this appears unappreciative to the JuliaObserver devs (the current destination of that link), but I didn’t get the impression there were particularly serious intentions to maintain that (correct me if I’m wrong).

---

<div class="post-metadata">

**Author:** ![viralbshah](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/viralbshah/32/54_2.png) [@viralbshah](https://discourse.julialang.org/u/viralbshah)\
**Post date:** [April 2, 2019, 2:30pm UTC](https://discourse.julialang.org/t/new-pkg-julialang-org/22622/20 "2019-04-02T14:30:20Z")

</div>

I will add [pkg.julialang.org](http://pkg.julialang.org) in addition to JuliaObserver. In fact when the [julialang.org](http://julialang.org) website went live originally, we had links to both.

[Next page](https://discourse.julialang.org/t/new-pkg-julialang-org/22622.md?page=2)