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

Track TODOs for graduation #3283

Closed
11 tasks done
Tracked by #1301
wu-sheng opened this issue Oct 14, 2023 · 18 comments
Closed
11 tasks done
Tracked by #1301

Track TODOs for graduation #3283

wu-sheng opened this issue Oct 14, 2023 · 18 comments
Labels
documentation Improvements or additions to documentation help wanted Extra attention is needed

Comments

@wu-sheng
Copy link
Member

wu-sheng commented Oct 14, 2023

Hi OpenDAL community

I am glad to see that the status of the OpenDAL community keeps improving, and moving forward the graduation.
Here is a keep-update TODO list to track for the OpenDAL, to document what is noticed and should be fixed before graduation.

Reference

@wu-sheng wu-sheng added the documentation Improvements or additions to documentation label Oct 14, 2023
@Xuanwo
Copy link
Member

Xuanwo commented Oct 17, 2023

Website status check.

image

@tisonkun
Copy link
Member

Update reference - https://incubator.apache.org/guides/graduation.html

@tisonkun tisonkun added the help wanted Extra attention is needed label Oct 18, 2023
@tisonkun
Copy link
Member

Podling metadata is updated at - https://svn.apache.org/repos/asf/incubator/public/trunk/content/podlings/opendal.yml

Name search should be done as stated in #3614. @Xuanwo would you open an issue at the referred JIRA project? It should be intuitive with the example linked in #3614.

@tisonkun
Copy link
Member

Project status is updated at - https://svn.apache.org/repos/asf/incubator/public/trunk/content/projects/opendal.xml

You can check the rendered version - https://incubator.apache.org/projects/opendal.html

The file should be kept updated during our new releases and new committers.

@wu-sheng
Copy link
Member Author

wu-sheng commented Dec 12, 2023

#3677

Question, I am not sure whether this is suitable for the website. The link should be permanent. But from the place on your website, I doubt it is meaningful after graduation.

@wu-sheng
Copy link
Member Author

#3615

It is good to see the dependencies. Meanwhile, the project team should have a mechanism to manage these dependencies rather than a one-time evaluation for graduation only.
Your dependencies(including languages) could change with time. It could be CI driven or manually or both, but those LICENSEs of dependencies are expected to exist when you release and are expected to update in time always.

@wu-sheng
Copy link
Member Author

image

About #3317, from the website, it is still unclear. What I was proposing is, that this helps for the community, rather than fit my own or foundation requirements only.
You put them as a top-level menu, and there is also documentation and codebases to show how to use them. How the end users will know these are actually not usable? No official release?
Personally, if that is never released, it doesn't exist from ASF perspective. If you have dev doc, it may be reasonable.

@tisonkun
Copy link
Member

Your dependencies(including languages) could change with time. It could be CI driven or manually or both, but those LICENSEs of dependencies are expected to exist when you release and are expected to update in time always.

For dependencies, IIUC only runtime deps are counted? If so, we can use cargo deny to generate the major deps and as stated in the issue, most of bindings doesn't have extra runtime deps so manually maintain the deps (most are N/A so we can omit) should be enough.

@tisonkun
Copy link
Member

tisonkun commented Dec 12, 2023

Question, I am not sure whether this is suitable for the website. The link should be permanent. But from the place on your website, I doubt it is meaningful after graduation.

It's something like a Wiki to document a status at the time. I agree that it doesn't have to be on the website, but it's OK to be on the website also IMO.

BTW, I linked to https://github.com/apache/kvrocks-website/blob/main/maturity.md in the issue but actually the text is simply place there, which doesn't show on the website ;-)

@wu-sheng
Copy link
Member Author

Your dependencies(including languages) could change with time. It could be CI driven or manually or both, but those LICENSEs of dependencies are expected to exist when you release and are expected to update in time always.

For dependencies, IIUC only runtime deps are counted? If so, we can use cargo deny to generate the major deps and as stated in the issue, most of bindings doesn't have extra runtime deps so manually maintain the deps (most are N/A so we can omit) should be enough.

Anyway, the project wants, it works. I just highlight this to help the community understands that, this is an important and long-term action item for the community, rather than one time work for the graduation.

@wu-sheng
Copy link
Member Author

It's something like a Wiki to document a status at the time. I agree that it doesn't have to be on the website, but it's OK to be on the website also IMO.

Yes, it is OK to be there, but once the graduation is done, and being done for years, are we still OK to post this? I don't want a deadline with time.

@Xuanwo
Copy link
Member

Xuanwo commented Dec 12, 2023

Yes, it is OK to be there, but once the graduation is done, and being done for years, are we still OK to post this? I don't want a deadline with time.

@suyanhanx previously stored it in a GitHub repository, but I recommended making it visible at opendal.apache.org. Does anyone have other suggestions for where to host this document?

@Xuanwo
Copy link
Member

Xuanwo commented Dec 12, 2023

You put them as a top-level menu, and there is also documentation and codebases to show how to use them. How the end users will know these are actually not usable? No official release?

Got it. I have removed not released bindings docs from this menu.

We will add them back once we have UI/UX for stable (versioned) docs and dev docs.

@Xuanwo
Copy link
Member

Xuanwo commented Dec 12, 2023

Your dependencies(including languages) could change with time. It could be CI driven or manually or both, but those LICENSEs of dependencies are expected to exist when you release and are expected to update in time always.

DONE. Should be addressed by #3743

@tisonkun
Copy link
Member

tisonkun commented Dec 13, 2023

All the subtasks above are resolve. @apache/opendal-committers for PPMC members you can discuss to start a graduation thread.

Here is how Kvrocks PMC ever discussed but you don't have to follow its form.

@Xuanwo
Copy link
Member

Xuanwo commented Dec 13, 2023

Let's go! I'm going to start a discussion on the mail list.

@tisonkun
Copy link
Member

@Xuanwo
Copy link
Member

Xuanwo commented Jan 10, 2024

Proposed resolution has been sent, thank you all!

@Xuanwo Xuanwo closed this as completed Jan 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

3 participants