Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhancements to the front page #40

Open
novialriptide opened this issue May 6, 2023 · 3 comments
Open

Enhancements to the front page #40

novialriptide opened this issue May 6, 2023 · 3 comments
Labels
enhancement New feature or request

Comments

@novialriptide
Copy link
Collaborator

novialriptide commented May 6, 2023

How's this looking so far?

image

Few Suggestions

Remove the header "HPy - A better C API for Python" and turn it into a "hero" section to something similar to this: "The React Framework for the Web"

image

Move "What is HPy" contents to the hero section and just have "HPy provides a new API for extending Python in C. In other words, you use #include <hpy.h> instead of #include <Python.h>."

Convert the features section into something like this (https://rutgersesports.club):

image

@hodgestar
Copy link
Contributor

I'm definitely in favour of making the HPy - A better C API for Python bigger and more central.

Our users and community are perhaps a bit different to React or the sports club, so I'm trying to think through what kinds of people will arrive at our website and what they'll be looking for:

  • People who want to know what HPy is. They're likely Python developers who have heard about HPy and I want to know more. They're looking for a clear high-level summary of the main points with links to examples, more detail and reference documentation in case they want to know more.

  • People who are evaluating HPy. They might be core developers of a Python implementation or just developers in such topics. They need a high-level summary of the benefits, design choices made, a high-level summary of the porting process and a link to a thorough example of porting an existing C extensions to HPy. They'll want to know how extensions are compiled, how ABI versioning and compatibility works, and have an overview of what parts of the C API have been ported.

  • People who want to port an existing C extension to HPy. They new a high-level summary of the porting process, a detailed example and links to reference documentation.

  • People who want to create a new C extension using HPy. They need a tutorial, guides to particular tricky topics (e.g. HPyGlobal, argument parsing, string and tuple building), and links to reference documentation.

  • Potential HPy contributors. They need a welcoming message, a short guide to the development process, a link to the development Discord server, and perhaps an overview of the current state of development or a development roadmap.

Everyone needs to know where to reach out for help or clarification if they get stuck.

This is quite a big todo list, and I don't know if everyone will agree with it 100%, but we do have a chunk of this content already, we just need to expose and organize it better.

@novialriptide As a concrete next step, I would suggest producing a mock-up of the overall site structure (perhaps just the front page with notes saying "clicking this leads to ..."). Then everyone can chime in with what content we already have and everyone can help re-organize / improve / add to it as necessary.

@novialriptide
Copy link
Collaborator Author

I can definitely do a mockup in Adobe Photoshop or Figma. I'll post some designs here in a bit.

@novialriptide novialriptide pinned this issue May 6, 2023
@novialriptide novialriptide added the enhancement New feature or request label May 7, 2023
@novialriptide
Copy link
Collaborator Author

My finals are almost done! (It starts in 12 hours)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants