Documentation cleanup and enhancements

- Fixed duplicate sections in README
- Added JSON file credentials loading example to README
- Fixed typos and corrected URLs in documentation
- Removed empty/placeholder sections
- Added scope customization as a TODO item
- Fixed broken markdown link in STYLE.md

Author: jpstroop

.gitignore

@@ -58,5 +58,5 @@ _scripts
 _cov_html
 secrets.json
 tokens.json
-TODO.mdø
+TODO.md
 

README.md

@@ -94,58 +94,67 @@ client = FitbitClient(
     client_id="YOUR_CLIENT_ID",
     client_secret="YOUR_CLIENT_SECRET",
     redirect_uri="YOUR_REGISTERED_REDIRECT_URI",
-    token_cache_path="/tmp/fb_tokens.json"  # Optional: saves tokens between sessions
-    redirect_uri="YOUR_REGISTERED_REDIRECT_URI",
-    token_cache_path="/tmp/fb_tokens.json"  # Optional: saves tokens between sessions
+    token_cache_path="/tmp/fb_tokens.json" 
 )
 
 # Will open browser and handle callback automatically
 client.authenticate()
 ```
 
-The `token_cache_path` parameter allows you to persist authentication tokens
-between sessions. If provided, the client will:
+You can also load your credentials from a JSON file, which is useful for keeping
+secrets out of your code:
 
-1. Load existing tokens from this file if available (avoiding re-authentication)
+```python
+from json import load
+from fitbit_client import FitbitClient
 
-2. Save new or refreshed tokens to this file automatically
+# Load credentials from a JSON file
+with open("secrets.json") as f:
+    secrets = load(f)
 
-3. Handle token refresh when expired tokens are detected The `token_cache_path`
-   parameter allows you to persist authentication tokens between sessions. If
-   provided, the client will:
+# Initialize Fitbit OAuth2 flow and get a client
+client = FitbitClient(**secrets)
 
-4. Load existing tokens from this file if available (avoiding re-authentication)
+# Authenticate as usual
+client.authenticate()
+```
 
-5. Save new or refreshed tokens to this file automatically
+Where secrets.json contains:
 
-6. Handle token refresh when expired tokens are detected
+```json
+{
+  "client_id": "YOUR_CLIENT_ID",
+  "client_secret": "YOUR_CLIENT_SECRET",
+  "redirect_uri": "https://localhost:8080"
+}
+```
 
-## Setting Up Your Fitbit App
+You can also include the optional token_cache_path:
 
-1. Go to dev.fitbit.com and create a new application
-2. Set OAuth 2.0 Application Type to "Personal"
-3. Set Callback URL to "https://localhost:8080" (or your preferred local URL)
-4. Set Callback URL to "https://localhost:8080" (or your preferred local URL)
-5. Copy your Client ID and Client Secret
+```json
+{
+  "client_id": "YOUR_CLIENT_ID",
+  "client_secret": "YOUR_CLIENT_SECRET",
+  "redirect_uri": "https://localhost:8080",
+  "token_cache_path": "/tmp/tokens.json"
+}
+```
 
-## Additional Documentation
+The `token_cache_path` parameter allows you to persist authentication tokens
+between sessions. If provided, the client will:
 
-### For API Library Users
+1. Load existing tokens from this file if available (avoiding re-authentication)
 
-- [LOGGING.md](docs/LOGGING.md): Understanding the dual-logger system
-- [TYPES.md](docs/TYPES.md): JSON type system and method return types
-- [NAMING.md](docs/NAMING.md): API method naming conventions
-- [VALIDATIONS.md](docs/VALIDATIONS.md): Input parameter validation
-- [ERROR_HANDLING.md](docs/ERROR_HANDLING.md): Exception hierarchy and handling
+2. Save new or refreshed tokens to this file automatically
 
-It's also worth reviewing
-[Fitbit's Best Practices](https://dev.fitbit.com/build/reference/web-api/developer-guide/best-practices/)
-for API usage.
+3. Handle token refresh when expired tokens are detected
 
-### Project Best Practices
+## Setting Up Your Fitbit App
 
-- [DEVELOPMENT.md](docs/DEVELOPMENT.md): Development environment and guidelines
-- [STYLE.md](docs/STYLE.md): Code style and formatting standards
+1. Go to dev.fitbit.com and create a new application
+2. Set OAuth 2.0 Application Type to "Personal"
+3. Set Callback URL to "https://localhost:8080" (or your preferred local URL)
+4. Copy your Client ID and Client Secret
 
 ## Additional Documentation
 
@@ -178,13 +187,6 @@ The methods are implemented in comments and should work, but I have not had a
 chance to verify them since this requires a publicly accessible server to
 receive webhook notifications.
 
-If you're using this library with subscriptions and would like to help test and
-implement this functionality, please open an issue or pull request!
-[webhook subscriptions](https://dev.fitbit.com/build/reference/web-api/developer-guide/using-subscriptions/).
-The methods are implemented in comments and should work, but I have not had a
-chance to verify them since this requires a publicly accessible server to
-receive webhook notifications.
-
 If you're using this library with subscriptions and would like to help test and
 implement this functionality, please open an issue or pull request!
 

docs/DEVELOPMENT.md

@@ -45,8 +45,8 @@
 1. Clone the repository:
 
 ```bash
-git clone https://github.com/yourusername/fitbit-client.git
-cd fitbit-client
+git clone https://github.com/jpstroop/fitbit-client-python.git
+cd fitbit-client-python
 ```
 
 2. Install asdf plugins and required versions:
@@ -129,8 +129,8 @@ import typing
 import datetime
 ```
 
-The one excpetion to this rule is when an entire module needs to be `mock`ed for
-testing, in which case, at least for the `json` package from the standare
+The one exception to this rule is when an entire module needs to be `mock`ed for
+testing, in which case, at least for the `json` package from the standard
 library, the entire package has to be imported. So `import json` is ok when that
 circumstance arises.
 
@@ -378,10 +378,6 @@ The OAuth callback mechanism is implemented using two main classes:
    - Removing temporary certificate files
    - Clearing internal state
 
-### Security Notes
-
-TODO
-
 ## Git Workflow
 
 1. Create a new branch for your feature/fix
@@ -391,7 +387,8 @@ TODO
 
 ## Release Process
 
-TODO
+The release process will be documented as the project nears its first public
+release.
 
 ## Getting Help
 

docs/STYLE.md

@@ -2,10 +2,10 @@
 
 Linting and formatting are handled by [Black](https://github.com/psf/black),
 [isort](https://github.com/pycqa/isort/),
-[mdformat](https://github.com/pycqa/isort/),
-[autoflake](https://github.com/PyCQA/autoflake) and a \[small script that adds a
-path comment)[lint/add_file_headers.py]. That said, here are some general
-guidelines:
+[mdformat](https://github.com/executablebooks/mdformat),
+[autoflake](https://github.com/PyCQA/autoflake) and a
+[small script that adds a path comment](/lint/add_file_headers.py). That said,
+here are some general guidelines:
 
 ## Code Organization and Structure