GoogleChrome / chrome-extensions-samples

Chrome Extensions Samples
https://developer.chrome.com/docs/extensions
Apache License 2.0
15.48k stars 8.23k forks source link

Need to write READMEs for all samples #798

Open jpmedley opened 1 year ago

jpmedley commented 1 year ago

One paragraph each:

Exclude MV2 samples.

shreya024 commented 1 year ago

@jpmedley I would like to work on this issue.Kindly assign

jpmedley commented 1 year ago

Thank you! This kind of thing requires a consistent format. We have instructions drafted, but haven't published them yet. I will get back to you in a day or two.

cc @oliverdunk

shreya024 commented 1 year ago

Thank you! This kind of thing requires a consistent format. We have instructions drafted, but haven't published them yet. I will get back to you in a day or two.

cc @oliverdunk

Okay thank you

jpmedley commented 1 year ago

Gang,

Thank you for your offer of help. We finally have instructions for how to do a README.

The reason I asked you to wait is that for an application like this, we want the instructions to be fairly consistent from one README to the next. Please follow these instructions.

If you run into anything that doesn't fit, ask yourself if it could apply to more than just the README you're working on and contact me (jmedley@google.com) with your proposed solution.

Thanks, Joe

tusharv01 commented 1 year ago

please assigned me this issue

jpmedley commented 1 year ago

Thank you for your offer of help. Since we have several other people working on this, it doesn't need to be assigned for you to work on it. Please just pick a few that you want to write for and announce in this thread that you're working on them so that we don't duplicate effort.

Thanks.

shreya024 commented 1 year ago

Thank you for your offer of help. Since we have several other people working on this, it doesn't need to be assigned for you to work on it. Please just pick a few that you want to write for and announce in this thread that you're working on them so that we don't duplicate effort.

Thanks.

@jpmedley I'm working on the api-samples

jpmedley commented 1 year ago

Is anyone else on this thread working in that folder? We may need to coordinate.

ankitoid commented 1 year ago

@jpmedley I am new GSOC contributor and i would like to work on this issue. Kindly assign

oliverdunk commented 1 year ago

Just to re-iterate what @jpmedley said, we don't want to assign an issue as big as this, since there are a number of samples and it's better to spread the work out. If you'd like to work on this, please pick a specific sample and either mention you're working on it here or open a separate issue for that specifically that we can assign you to. Thanks! :)

@shreya024: If you could pick some specific samples that would be great!

shreya024 commented 1 year ago

Just to re-iterate what @jpmedley said, we don't want to assign an issue as big as this, since there are a number of samples and it's better to spread the work out. If you'd like to work on this, please pick a specific sample and either mention you're working on it here or open a separate issue for that specifically that we can assign you to. Thanks! :)

@shreya024: If you could pick some specific samples that would be great!

I would like to work on Action ,alarms , contextMenus and cookies

oliverdunk commented 8 months ago

We are very nearly there, but I think there are a couple remaining (an example is sample.page-redder).

btwshivam commented 8 months ago

hey, I would love to work on this issue. Assign me!

oliverdunk commented 8 months ago

@shivam200446, if you could pick specific READMEs you'd like to work on feel free to post here and then open a PR. I'm going to avoid assigning anyone specific for now since depending on how many there are it may make sense to split up the work :)

Pask00 commented 8 months ago

I will work on sample.page-redder and sample.bookmarks!

oliverdunk commented 8 months ago

Thanks @Pask00! @shivam200446, feel free to take a look and see if that leaves anything - if not, we still need a sample for the chrome.management API. If you want something to work on you could start by opening an issue talking about what that could look like and we can discuss there.

abrehan2 commented 8 months ago

Dear Mr. @jpmedley,

I hope this message finds you well. I have a question regarding the creation of README files for the API samples. Should I prepare a README for each individual sample within the api-samples category, or would a single README covering all samples suffice? Can you please suggest which samples are left to work on. :)

Thank you for your clarification.

Best regards, Rehan

oliverdunk commented 8 months ago

Should I prepare a README for each individual sample within the api-samples category, or would a single README covering all samples suffice? Can you please suggest which samples are left to work on. :)

This should be a single README in each sample directory (alongside manifest.json), following the template in the root of the repository. We don't have a full list of samples needing READMEs but here is an example.

As mentioned above please do comment about the specific READMEs you want to look at so we can avoid overlap and leave some for everyone. Do check above to see if one is already claimed.

abrehan2 commented 8 months ago

Can I work on the one you just mentioned?

On Fri, 23 Feb 2024 at 19:20, Oliver Dunk @.***> wrote:

Should I prepare a README for each individual sample within the api-samples category, or would a single README covering all samples suffice? Can you please suggest which samples are left to work on. :)

This should be a single README in each sample directory (alongside manifest.json), following the template in the root of the repository. We don't have a full list of samples needing READMEs but here is an example https://github.com/GoogleChrome/chrome-extensions-samples/tree/main/functional-samples/tutorial.tabs-manager .

As mentioned above please do comment about the specific READMEs you want to look at so we can avoid overlap and leave some for everyone. Do check above to see if one is already claimed.

— Reply to this email directly, view it on GitHub https://github.com/GoogleChrome/chrome-extensions-samples/issues/798#issuecomment-1961410287, or unsubscribe https://github.com/notifications/unsubscribe-auth/AYBTD24HTUQALOFAXEE4JZTYVCQUHAVCNFSM6AAAAAATRMYPNSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTSNRRGQYTAMRYG4 . You are receiving this because you commented.Message ID: @.***>

oliverdunk commented 8 months ago

Can I work on the one you just mentioned?

Sure (for others, @abrehan2 is going to work on functional-samples/tutorial.tabs-manager) 👍

Note that this is based on https://developer.chrome.com/docs/extensions/get-started/tutorial/popup-tabs-manager so please include a link to it and use it for context around the intended use case :)

professorabhay commented 8 months ago

Hey, @oliverdunk! I would like to work on tutorial.getting-started readme file. May I?

hrmtsh2 commented 8 months ago

Greetings @oliverdunk and other community members! I would like to work on this issue, as well as potentially write samples for some APIs. Kindly refer to me the most important ones which need a README and/or samples. As of now, I am eyeing functional-samples/tutorials.X that lack READMEs. Kindly let me know if I can go ahead (and if anyone else is working on those as well)!

jpmedley commented 8 months ago

@hrmtsh2, thank you for the offer of help. @oliverdunk will give you information about creating samples. If you have time for a few READMEs, here's a template to help you get started.

mahitoburrito commented 8 months ago

Hello @oliverdunk and @jpmedley, I would like to work on this issue and complete a couple READMEs and samples. Please let me know if there are any I can get started on!

bluishhh commented 7 months ago

Greetings @oliverdunk and @jpmedley, I would like to work on this issue. As per my observation, we need READMEs on functional-samples/sample.water_alarm_notification and functional-samples/tutorial.focus-mode, please let me know if i can get started with them.

I am also interested in creating API samples, so please share the instructions and specifications for it as well.

hrmtsh2 commented 7 months ago

@bluishhh I have already covered those two in PR #1124. However, I would love to have your suggestions on improving!

YUNGU23 commented 7 months ago

Hello! I'm currently working on the README files below, so you can avoid duplicating the effort.

  1. api-samples.declarativeNetRequest.url-blocker
  2. api-samples.printing
  3. functional-samples.cookbook.sidepanel-global
  4. functional-samples.cookbook.sidepanel-multiple
  5. functional-samples.cookbook.sidepanel-open
  6. functional-samples.reference.mv3-content-scripts
  7. functional-samples.sample.catifier
  8. functional-samples.sample.co2meter
  9. functional-samples.sample.sidepanel-dictionary
  10. functional-samples.tutorial.google-analytics
YUNGU23 commented 7 months ago

Hello! I'm currently working on the README files below, so you can avoid duplicating the effort.

  1. api-samples.declarativeNetRequest.url-blocker
  2. api-samples.printing
  3. functional-samples.cookbook.sidepanel-global
  4. functional-samples.cookbook.sidepanel-multiple
  5. functional-samples.cookbook.sidepanel-open
  6. functional-samples.reference.mv3-content-scripts
  7. functional-samples.sample.catifier
  8. functional-samples.sample.co2meter
  9. functional-samples.sample.sidepanel-dictionary
  10. functional-samples.tutorial.google-analytics

I have submitted PR #1129 updating the above READMEs. Your feedback and suggestions would be greatly appreciated. @oliverdunk @jpmedley

gigimyz commented 7 months ago

Hello @oliverdunk and @jpmedley, I would like to work on this issue, please let me know if there are any REAMEs and samples that I can get started and work on!

mahitoburrito commented 7 months ago

Hi! I submitted PR #1138 updating the README for functional-samples.tutorial.reading-time. Any feedback would be appreciated!

Recxsmacx commented 1 month ago

/assign

Maliksb11 commented 1 month ago

ok