Comments (8)
I guess we can add examples, but it can be convoluted, which is opposite to the purpose of this page which in turn to give an overview of all the type classes.
I think if we have examples in the java doc, for each function is enough. wdyt?
from cats.
I think if we have examples in the java doc, for each example is enough. wdyt?
good point! :)
from cats.
- We have to keep update the docs url with scala version and cats version.
We can use @VERSION@
mdoc variable to keep the Cats version in sync. What if we link to the Scala 3 docs, does that work for going straight to the function?
- CI failed at generating the site
Hmmm. I wonder if it helps to put the links at the bottom of the doc instead of inline.
Thanks for your work on this!!
from cats.
thanks!
The scala 3 docs version works 💯
I also tried @VERSION@
with hope that mdoc works, because the scala 3 docs url is much simpler than the scala 2 docs with a lot of [][][][] :D
from cats.
Thank you, that sounds good to me! I wonder if we should add an example of how to use it with syntax as well? Since it's a bit different than calling the method directly on the typeclass.
from cats.
I did add some link here https://github.com/lenguyenthanh/cats/blob/add-links-for-glossary-page/docs/nomenclature.md.
But there are few issues, I can see right away (and not sure how to fix):
- CI failed at generating the site: https://github.com/lenguyenthanh/cats/actions/runs/5258938812/jobs/9503832137#step:10:1036
- java docs urls don't open at the function location like this link. This can be really confused to the readers.
- We have to keep update the docs url with scala version and cats version.
from cats.
after switching to scala 3 docs url, everything passes: https://github.com/lenguyenthanh/cats/actions/runs/5259440112
But I can't build the site locally. Both docs/tlSitePreview
and docs/tlSite
shutdown the sbt after a lot of warning like this: https://gist.github.com/lenguyenthanh/df88115b7af5b974d0324c3c2a712df6
But they did generate md files in site/target/mdoc
, and the generated files look correct.
from cats.
shutdown the sbt
ugh, that's scalameta/mdoc#613
so that means that there are errors that need to be fixed
https://gist.github.com/lenguyenthanh/df88115b7af5b974d0324c3c2a712df6#file-cats-txt-L234
probably this?
https://gist.github.com/lenguyenthanh/df88115b7af5b974d0324c3c2a712df6#file-cats-txt-L192-L199
from cats.
Related Issues (20)
- Type-classes for Prepend (Cons) and Append (Snoc) operations HOT 5
- Scala 3: No given instance of type cats.Applicative[[_] =>> Any] was found for parameter F of method apply in class PurePartiallyApplied
- Unusual EqLaws definition HOT 4
- Outdated Link in Docs - Seeking Guidance for Fix HOT 1
- algebra-core/src HOT 1
- Option size method implicitly selected from UnorderedFoldable HOT 2
- IndexedStateT has superfluous parts HOT 4
- .splitWhen
- Difference in the Applicative inferred for Seq[Seq[?]]#sequence between Scala 2 and 3
- Inconsistent behaviour when using Eval as Applicative
- `Tuple1SemigroupalOps` methods have different names from other `TupleNSemigroupalOps` classes HOT 3
- Instances for Currency HOT 7
- EitherT[Option, ?, ?]] can't be used as a bifunctor HOT 5
- trait EuclidianRing should not be a Ring HOT 4
- OutOfMemoryError when IO.uncancelable is used in recursive function HOT 1
- ambiguous implicit resolution of `Show.ContravariantShow[immutable.SortedMap[K, V]]` HOT 1
- Should Monad extend Defer? HOT 11
- Support Scala Native 0.5 HOT 3
- Adding an alternative version of the method whenA with a different signature
- `Eval` thread safety HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from cats.