Add docs for kotlin:ank:playground

[nomisRev]

No description provided.

[JorgeCastilloPrz]

I would add a reminder about the need for having all the sources you need in the snippet otherwise it'll fail. Also clarify that if you need to showcase compile time generated syntax you'll need to copy those generated elements on the snippet, given Playgrounds can only depend on the sources in the snippet, and the playgrounds server doesn't run kapt either.

About the different behavior between Ank and playgrounds when it comes to classpath dependencies: Playgrounds can also work incrementally so you don't need to redeclare everything on every single snippet, like Ank does. You can do it with an "incremental" flag but last time I tried random stuff failed, so I'm not completely sure whether that works fine.

[rachelcarmena]

Awesome @nomisRev 🙌 I didn't realize about those details for every modifier. Maybe we could re-organize the content for a better understanding:

• language:ank
• language:ank:<modifier> for every modifier in the same order of the table and a note together the table to know that there are details and examples for every modifier

Note: checks are not run for this pull request because they are not necessary for README changes. Just merge when having 2 approvals. Thanks!!

[rachelcarmena]

Hi fellow contributor 👋

Arrow repositories has been reunified again into arrow so this repository is going to be archived.

Please, if you want to replay this pull request on arrow repository, follow these steps:

# Adapt your branch to be able to be merged in the new arrow repository
cd arrow-ank
git-filter-repo --to-subdirectory-filter arrow-libs/ank
cd ..

# Create a new branch in arrow repository and merge your content
git clone git@github.com:arrow-kt/arrow.git
cd arrow
git checkout -b <new-branch>
git remote add arrow-ank ../arrow-ank
git fetch arrow-ank
git merge --no-edit --allow-unrelated-histories arrow-ank/<your-branch>
# check and create the pull request again on arrow repository

Please, let us know if we can help you!

Thank you so much for your contributions!! 🙌