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

add use-cases-wp.doc to compliance folder #1308

Closed
wants to merge 1 commit into from

Conversation

hubbertsmith
Copy link

No description provided.

Signed-off-by: hubbert Smith <[email protected]>
Copy link

netlify bot commented Jul 3, 2024

Deploy Preview for tag-security ready!

Name Link
🔨 Latest commit ce89b59
🔍 Latest deploy log https://app.netlify.com/sites/tag-security/deploys/668564e6c7d5d8000827886b
😎 Deploy Preview https://deploy-preview-1308--tag-security.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@eddie-knight
Copy link
Collaborator

Hey @hubbertsmith, since this is an empty file I'm gonna change this PR to a draft for now. When you have content committed and ready for review, all you'll need to do is add a description to the PR and take it out of draft mode.

@eddie-knight eddie-knight marked this pull request as draft July 6, 2024 02:45
@hubbertsmith
Copy link
Author

hubbertsmith commented Jul 6, 2024 via email

@hubbertsmith
Copy link
Author

@hubbertsmith
Copy link
Author

hubbertsmith commented Jul 6, 2024 via email

@anvega
Copy link
Contributor

anvega commented Jul 6, 2024

Thanks, @hubbertsmith! So, GitHub is designed primarily for code and text-based files. Word (.doc) files are binary formats that GitHub can't render or preview directly in the web interface.

Couple steps:

Convert to Markdown:

  1. Open your Word document
  2. Copy the content
  3. Paste into a markdown editor (e.g., VS Code with markdown extension, online tools like StackEdit)
  4. Format your content using markdown syntax:
    • Use # for headings (e.g., # Heading 1, ## Heading 2)
    • Use - for bullet points
    • Use 1. 2. 3. for numbered lists
    • Enclose text in ** for bold, * for italic
  5. Save the file with a .md extension (e.g., compliance_usecases.md)

Add to Your Branch:

  1. Ensure you're on your hubbertsmith:patch-1 branch
  2. Add the new markdown file to your repository
  3. Commit the changes
  4. Push to your branch on GitHub

If the document must remain in Word format, you can still add it to the repository, but users will need to download it to view the content

@hubbertsmith
Copy link
Author

hubbertsmith commented Jul 6, 2024 via email

@anvega
Copy link
Contributor

anvega commented Jul 6, 2024

Thank you for your explanation. I understand your situation better now. However, I want to clarify a few points about our repository practices:

We don't currently have any .doc files in our repository. Instead, we use links to Google Docs and PDFs for content with complex formatting. PDFs are proofed and designed by CNCF tech writers which can be done by opening a ticket with them.

For your document, we suggest the following options:
a. Convert the file to a Google Doc and provide a link in the README.md file. This maintains formatting while allowing easy access and collaborative editing.
b. Convert to markdown. While you mentioned formatting, tables, and ToC as potential issues, these are actually quite manageable in markdown. I'd be happy to assist you with this conversion early next week if you'd like.

If you prefer to keep it as a .doc file, please note that while Git can version control .doc files, it won't be able to show meaningful diffs on GitHub's web interface. This makes reviewing changes more difficult. If you decide to stick with the .doc format for now, we can certainly work with that. You can add it to your hubbertsmith:patch-1 branch, and reviewers will need to clone the repository and open it with Word to review it fully.

Let me know which option you prefer, or if you have any questions about these approaches. We're here to help make this process as smooth as possible for you.

@hubbertsmith
Copy link
Author

hubbertsmith commented Jul 6, 2024 via email

@anvega
Copy link
Contributor

anvega commented Jul 6, 2024

I've taken the liberty of uploading your file to our shared Google Drive and granting you editor rights. You can now access and edit the document here:

https://docs.google.com/document/d/1l_4HHtYVXG2dG5Y1WRzmMrdt_IcTqMHPL8u6ZQ1Zc9A

@hubbertsmith
Copy link
Author

hubbertsmith commented Jul 6, 2024 via email

@anvega anvega closed this Jul 9, 2024
@hubbertsmith
Copy link
Author

hubbertsmith commented Jul 26, 2024 via email

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.

3 participants