strawberry-graphql / strawberry.rocks Goto Github PK

I'm using SSR with Astro, but the content is pretty much static, we just need a way to update the content when pushing on the main Strawberry repo.

There are testing/fuzzing tools named hypothesis-graphql (and the higher level schemathesis) available.

By fuzzing through the schema they can speed up testing and find corner cases.

It would be nice if there would some documentation how to integrate them (they work on asgi/stringified graphl schema)

I was thinking this day to move away from Gatsby, I love the idea of statically building the site, but as we will introduce the following features:

• Versioning docs #8
• Support for translations

the build would take a lot of time, unless we start caching thigns heavily, but even now the generation of the site seem to take a bit of time. As we have docs previews from the main repo, maybe switching from to a SSR approach might be better :)

https://expressive-code.com/

https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md

h1 and h2 have the same size:

content is too wide:

Search is wide:

Describe the Bug

Private fields not private in Python 3.12. I reproduced with the following code:

import strawberry

@strawberry.type
class User:
    name: str
    age: int
    secret: str = strawberry.Private[str]

@strawberry.type
class Query:
    @strawberry.field
    def user(self) -> User:
        return User(name="Patrick", age=100, secret="can't tell")

schema = strawberry.Schema(query=Query)

and I see the following at http://0.0.0.0:8000/graphql:

System Information

• Operating system: Apple M1 Sonoma | Python 3.12
• Strawberry version (if applicable): 0.218.1

Feature Request Type

• Core functionality
• Alteration (enhancement/optimization) of existing feature(s)
• New behavior

Description

I am listing this issue to ask for a little alteration on the README.md file to explain how the translations could be added here.
Also, I do not see a place where it is possible to see the progress of the implementation of the translation support feature.

@patrick91 if you have time, do you mind?

Feature Request Type

• Core functionality
• Alteration (enhancement/optimization) of existing feature(s)
• New behavior

Description

The workshop page from PyCon is really good and also really hard to find. It would be great if there were links to this page and to the video as well somewhere easy to find. Or at least integrate that info into the docs.

Describe the Bug

The "Share" button on https://play.strawberry.rocks/ is currently broken:

1. Click the button
2. Observe "Loading..." prompt
3. BUG: finishes loading but link box remains empty
   

There's two network requests and both fail:

OPTIONS: response is a 500.

curl 'https://api.strawberry.rocks/graphql' -X OPTIONS -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:123.0) Gecko/20100101 Firefox/123.0' -H 'Accept: */*' -H 'Accept-Language: en-US,en;q=0.5' -H 'Accept-Encoding: gzip, deflate, br' -H 'Access-Control-Request-Method: POST' -H 'Access-Control-Request-Headers: content-type' -H 'Referer: https://play.strawberry.rocks/' -H 'Origin: https://play.strawberry.rocks' -H 'DNT: 1' -H 'Connection: keep-alive' -H 'Sec-Fetch-Dest: empty' -H 'Sec-Fetch-Mode: cors' -H 'Sec-Fetch-Site: same-site'

POST: doesn't seem to run, likely because the OPTIONs fails.

curl 'https://api.strawberry.rocks/graphql' -X POST -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:123.0) Gecko/20100101 Firefox/123.0' -H 'Accept: */*' -H 'Accept-Language: en-US,en;q=0.5' -H 'Accept-Encoding: gzip, deflate, br' -H 'content-type: application/json' -H 'Content-Length: 463' -H 'Origin: https://play.strawberry.rocks' -H 'DNT: 1' -H 'Connection: keep-alive' -H 'Referer: https://play.strawberry.rocks/' -H 'Sec-Fetch-Dest: empty' -H 'Sec-Fetch-Mode: cors' -H 'Sec-Fetch-Site: same-site'

System Information

• Operating system: macOS. Safari, Chrome & Firefox
• Strawberry version (if applicable): 0.277.3

Additional Context

The playground is awesome! 🍓

Hi there,
It seems that this official integration section for django is not right (or has outdated information)?

Describe the Bug

So in this repo https://github.com/strawberry-graphql/strawberry-graphql-django/blob/97cdea29867d33b2bfd75b67a4310dd6cc147ddc/examples/django/app/schema.py#L5

you can see we are importing from strawberry_django but in the official docs we are importing from strawberry.django

Is this intentional? or is the website outdated?

System Information

• Operating system: Windows 11
• Strawberry version : "0.155.3"

Additional Context

As noted in the readme, this is currently broken after the switch to next.js

https://strawberry.rocks/docs/pr/1345/guides/pagination/offset-based

We had this kinda working for the previous setup. We can improve this now since we have SSR, we can allow PRs with a specific label (ie. preview-docs) or by core devs to be previewed using a link like this:

https://strawberry.rocks/docs/pr/123/general/schema-basics

where 123 is the id of the PR. We could use a subdomain too, but I think it is easier to use one :)

Just for fun

I mean, with a domain like strawberry.rocks that really invites an exploration with dall-e. Here are two of my favourites :)

Thanks for your hard work here, folks!

~~ Tom ~~

Right now we use fetchTableOfContentsPaths but that doesn't fetch the nested pages, we should fetch them so we statically render also pages like the extensions pages

Go here: https://strawberry.rocks/docs/schema-basic

You'll see:

Instead of:

The copy button and scrollbar which belong to code snippets are visible on mobile when the navbar is pulled down.

Screenshot:

Possible fix: increase navbar's z-index

I have only noticed this on the pydantic page https://strawberry.rocks/docs/integrations/pydantic
It is probably the only page where the inline code is one string that is long enough
It looks especially bad in dark mode

Proposed solution:
I think a break-words in the inline code class here should fix it but wanted to check in before doing the PR in case anyone has a better idea
There probably are other ways like text-ellipsis or text-clip but I would say we want to display the whole string

https://tailwindcss.com/docs/installation

We should have a top level "sidebar":

• Documentation / Getting started
• Changelog/Breaking changes
• Django
• SQLAlchemy
• Discord

It would be nice to have our strawbwerry-django docs (https://strawberry-graphql.github.io/strawberry-django/) inside a subpath of the main docs

Add table of contents to each docs page.

I think we should take inspiration from https://docusaurus.io/docs

Feature Request Type

• Core functionality
• Alteration (enhancement/optimization) of existing feature(s)
• New behavior

Description

Different versions of strawberry might need different documentation. It would be great to have strawberry documentation for backwards compatibility. Example issue:
strawberry-graphql/strawberry#3444 (comment)

Upvote & Fund

• We're using Polar.sh so you can upvote and help fund this issue.
• We receive the funding once the issue is completed & confirmed by you.
• Thank you in advance for helping prioritize & fund our backlog.