Skip to content

Conversation

@amoeba
Copy link
Member

@amoeba amoeba commented Mar 21, 2025

Note this reorders GitHub Issues and Discussions to be above Stack Overflow as SO seems to be significantly less popular now than it used to be.

Closes #629.

@amoeba amoeba requested a review from assignUser March 21, 2025 15:51
community.md Outdated

### GitHub Issues

We use [GitHub Issues](https://github.com/apache/arrow/issues) as a way to ask questions and engage with the Arrow developer
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'as a way to ask questions' seems redundant now that we have discussions?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add the GitHub issues for all repositories (arrow-java, arrow-go, ...) ?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should be more clear here. We should redirect users to ask questions to GitHub Discussions. As a new user with a question if I see three options I still would have no idea what is the preferred way. The current phrasing doesn't help in my opinion.
We have suggested in the past to redirect user questions to the mailing list when they were opened as issues. I feel this phrase was already outdated. I would say something in the lines:

We use GitHub Issues to track the queue of development work. Bugs and feature requests are welcome. For usage type questions we have GitHub Discussions and might redirect usage type issues to open the question there.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

and might redirect usage type issues to open the question there.

FWIW, if someone opens an issue that is clearly a usage question, we don't have to ask to open the question as a discussion instead, we (maintainers) should be able to click a button to convert the issue into a discussion/

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, wording changed in c5a078c.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jbonofre I think you're right. I'll change things around a bit.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

New text in ac8107b which points people to our repos and their issues/discussions.

Copy link
Member

@kou kou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1

community.md Outdated

### GitHub Issues

We use [GitHub Issues](https://github.com/apache/arrow/issues) as a way to ask questions and engage with the Arrow developer
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add the GitHub issues for all repositories (arrow-java, arrow-go, ...) ?

@amoeba
Copy link
Member Author

amoeba commented Apr 8, 2025

Thanks for the reviews so far. I think @jbonofre's point about directing users to the other repos was a good one so I overhauled the text in ac8107b. cc @jbonofre @raulcd @assignUser

@amoeba amoeba requested review from assignUser, jbonofre and raulcd April 8, 2025 18:51
Copy link
Member

@assignUser assignUser left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice!

Co-authored-by: Ian Cook <[email protected]>
amoeba added 3 commits April 9, 2025 11:53
I found two things out here:

1. %includes require we use inline HTML here to get the correct final HTML
2. We don't want a final trailing newline in %include templates or things go screwy with word breaks
@amoeba
Copy link
Member Author

amoeba commented Apr 9, 2025

Here's the latest local preview with my recent fixes,

Screenshot 2025-04-09 at 11 56 52 AM

cc @ianmcook

@amoeba amoeba merged commit 34ca4ea into apache:main Apr 10, 2025
1 check passed
@amoeba
Copy link
Member Author

amoeba commented Apr 10, 2025

Thanks all for the reviews. @jbonofre since you didn't get a chance for another review, let me know if you have any feedback and we can open another PR.

@jbonofre
Copy link
Member

@amoeba i will do a quick pass but it sounds good ;) thanks !

@raulcd
Copy link
Member

raulcd commented Apr 11, 2025

FYI, I've opened this issue on arrow-java to enable GitHub discussions to arrow-java, arrow-go and arrow-julia will update this doc once the rest have them enabled (if they do).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Website] Document GitHub Discussions on the Community page

8 participants