textreuse
textreuse copied to clipboard
Add official docs url to description
Hello from rOpenSci!
The official rOpenSci docs server which we announced in June is fully ready for production now. Our server automatically builds and hosts pkgdown sites for all ropensci packages.
- Official documentation URL: https://docs.ropensci.org/textreuse
- Website build logs: https://dev.ropensci.org/job/textreuse (click "last build" -> "console output")
If all seems good, we strongly suggest to add the URL to the package DESCRIPTION file and include this in the next CRAN update. This has two major benefits:
- Pkgdown does automatic cross-linking to other pkgdown sites that can be found via CRAN. This means that if another package refers to your package in an example or vignette, their pkgdown site automatically hyperlinks those functions to your pkgdown site (if your pkgdown URL has been published on CRAN!)
- Because all our documentation is hosted under
docs.ropensci.org
this will accumulate a higher pagerank than when a site are hosted on various custom domains. This should make it easier to find these documentation sites on Google and other search engines.
We hope that this service will make it easy to maintain high quality and visible documentation for your packages! If something is unclear or not working, feel free to ask questions here or on slack.
FAQ
1. What do I need to do to maintain documentation at docs.ropensci.org?
Absolutely nothing, everything is done automatically.
2. How can I customize my docs.ropensci.org site?
You can use all standard pkgdown options in your pkgdown.yml
file, except for the template (we use the rotemplate pkgdown theme to render).
3. Can I help to improve the template?
Of course! You can send pull requests to ropensci/rotemplate.
4. Why are the images from the readme.md not showing in my pkgdown site?
pkgdown only supports local images in a few locations since only a few locations also work with CRAN's rendering of readme's. The recommended path for static images is man/figures
.
5. I already had a site. How to create a redirect from my old pkgdown site?
Simply push an index.html
file to your gh-pages
branch which redirects to the new site, see for example here.
Codecov Report
Merging #87 into master will decrease coverage by
0.31%
. The diff coverage isn/a
.
@@ Coverage Diff @@
## master #87 +/- ##
==========================================
- Coverage 87.09% 86.77% -0.32%
==========================================
Files 25 25
Lines 674 658 -16
==========================================
- Hits 587 571 -16
Misses 87 87
Impacted Files | Coverage Δ | |
---|---|---|
R/align_local.R | 78.88% <0%> (-0.9%) |
:arrow_down: |
src/sw_matrix.cpp | 93.33% <0%> (-0.42%) |
:arrow_down: |
R/TextReuseCorpus.R | 82.35% <0%> (-0.34%) |
:arrow_down: |
R/lsh.R | 91.83% <0%> (-0.33%) |
:arrow_down: |
R/TextReuseTextDocument.R | 91.52% <0%> (-0.08%) |
:arrow_down: |
src/shingle_ngrams.cpp | 100% <0%> (ø) |
:arrow_up: |
src/hash_string.cpp | 100% <0%> (ø) |
:arrow_up: |
R/minhash.R | 100% <0%> (ø) |
:arrow_up: |
src/skip_ngrams.cpp | 100% <0%> (ø) |
:arrow_up: |
Continue to review full report at Codecov.
Legend - Click here to learn more
Δ = absolute <relative> (impact)
,ø = not affected
,? = missing data
Powered by Codecov. Last update 35f8421...ecc8859. Read the comment docs.