8000
Skip to content

Comprehensive EDGAR overview and usage quickstart guide - #313

Open
Dzeddy wants to merge 1 commit into
sec-edgar:masterfrom
Dzeddy:patch-1
Open

Comprehensive EDGAR overview and usage quickstart guide#313
Dzeddy wants to merge 1 commit into
sec-edgar:masterfrom
Dzeddy:patch-1

Conversation

@Dzeddy
@Dzeddy Dzeddy commented Sep 30, 2024
Copy link
Copy Markdown

This pull request significantly expands and enhances the "About" section of the secedgar documentation. The updates provide a more comprehensive introduction to both the SEC's EDGAR system and the secedgar tool, making it easier for new users to understand the context and value of the package.

Changes include:

  1. Extended introduction explaining the purpose and benefits of secedgar
  2. Detailed explanation of what EDGAR is and its importance in financial reporting
  3. Expanded section on how secedgar helps users interact with EDGAR data
  4. New "Getting Started" section with a basic usage example
  5. Improved overall structure and readability of the documentation

Motivation

The existing documentation, while informative, was quite brief. This expansion aims to:

  • Provide newcomers with a clearer understanding of EDGAR and its significance
  • Highlight the key features and benefits of using secedgar
  • Offer a quick-start guide to help users begin using the tool immediately
  • Improve the overall user experience and reduce the learning curve for new adopters

Testing

  • Verified all links are working correctly
  • Ensured code example runs without errors
  • Checked for any typos or grammatical issues
  • Confirmed accuracy of information about EDGAR and secedgar

Additional Notes

This PR focuses on the content of the documentation. If approved, we may want to consider additional enhancements in the future, such as:

  • Adding more advanced usage examples
  • Creating a separate "Tutorials" section
  • Including a FAQ for common issues or questions

Feedback and suggestions for further improvements are welcome!

  • closes #xxxx
  • tests added / passed
  • passes git diff upstream/master -u -- "*.py" | flake8 --diff
  • added entry to docs/whatsnew latest version

This pull request significantly expands and enhances the "About" section of the secedgar documentation. The updates provide a more comprehensive introduction to both the SEC's EDGAR system and the secedgar tool, making it easier for new users to understand the context and value of the package.

### Changes include:

1. Extended introduction explaining the purpose and benefits of secedgar
2. Detailed explanation of what EDGAR is and its importance in financial reporting
3. Expanded section on how secedgar helps users interact with EDGAR data
4. New "Getting Started" section with a basic usage example
5. Improved overall structure and readability of the documentation

### Motivation

The existing documentation, while informative, was quite brief. This expansion aims to:

- Provide newcomers with a clearer understanding of EDGAR and its significance
- Highlight the key features and benefits of using secedgar
- Offer a quick-start guide to help users begin using the tool immediately
- Improve the overall user experience and reduce the learning curve for new adopters

### Testing

- [x] Verified all links are working correctly
- [x] Ensured code example runs without errors
- [x] Checked for any typos or grammatical issues
- [x] Confirmed accuracy of information about EDGAR and secedgar

### Additional Notes

This PR focuses on the content of the documentation. If approved, we may want to consider additional enhancements in the future, such as:

- Adding more advanced usage examples
- Creating a separate "Tutorials" section
- Including a FAQ for common issues or questions

Feedback and suggestions for further improvements are welcome!
Comment thread docs/source/about.rst

1. Install the package: `pip install secedgar`
2. Import the necessary modules in your Python script
3. Create a `CompanyFilings` or `FilingType` object
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
3. Create a `CompanyFilings` or `FilingType` object
3. Create a `CompanyFilings` and `FilingType` object

Comment thread docs/source/about.rst

## Getting Started with secedgar

To begin using secedgar, you'll typically follow these steps:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
To begin using secedgar, you'll typically follow these steps:
To begin using secedgar, you can follow these steps:

@jackmoody11
Copy link
Copy Markdown
Member

Thanks @Dzeddy! Can you accept the changes I suggested, and then I will merge? Sorry for taking a while to get back on this.

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.

2 participants

0