search

cockroachdb / docs

CockroachDB user documentation
https://cockroachlabs.com/docs
Creative Commons Attribution 4.0 International
187 stars 453 forks source link

sql: uplevel the language pages in the documentation #5626

Open awoods187 opened 4 years ago

awoods187 commented 4 years ago

Andy Woods (awoods187) commented:

Currently, we have pages on languages that look like this: image

This is great content but we could uplevel it. We could have a landing page that talks all things Python. It could have links out to sample apps (like this page), show a list of all the ORMs available in the space (now that more are coming) and otherwise be a "this is what you need to know if you use Python with CRDB."

We can add MovR to this since it is a python and SQLAlchemy based app.

Jira Issue: DOC-345

awoods187 commented 4 years ago

We can also include links to the conferences we are going to in Python space etc.

awoods187 commented 4 years ago

We could also tackle this page concurrently https://www.cockroachlabs.com/docs/v19.1/third-party-database-tools.html#main-content

ericharmeling commented 4 years ago

From #6255:

Background: https://airtable.com/tblD3oZPLJgGhCmch/viw1DKmbKhg2MIECH/recBm7JyggA0iah6l

Description: Now, the docs repo provides one landing page each for Go, Java, and Python. These landing pages serve to coordinate and orient developers to the knowledge they need for each language. It will include all of the getting started guides for each supported ORM as well as any language specific tutorials.

Currently, developers have minimal information for how to program using their preferred application language with CockroachDB. We provide a sample toy application via a getting started guide for some, but not all of the supported ORMs.

Team: Andrew Woods, Rafi Shamim, Eric Harmeling, Richard Loveland

Github Tracking Issue: #5626