Update documentation

Author: amotl

README.md

@@ -38,7 +38,7 @@
 ## Setup
 
 ```shell
-pip install --upgrade 'git+https://github.com/crate-workbench/hubspot-tech-writing'
+pip install --upgrade hubspot-tech-writing
 ```
 
 After installation, you can verify if it was successful.
@@ -76,23 +76,30 @@ hstw linkcheck https://github.com/crate-workbench/hubspot-tech-writing/raw/main/
 
 ### HubSpot Upload
 
-Uploading to HubSpot is mostly an iterative process, so will likely need to use the
-program multiple times. In order ease invocation, we recommend to define an
-environment variable for storing your access token.
+Uploading to HubSpot is mostly an iterative process, so you will most likely need to use the
+program multiple times on the same resource. In order ease invocation, we recommend to define
+an environment variable for storing your access token to the HubSpot API.
 ```shell
 export HUBSPOT_ACCESS_TOKEN=pat-na1-e8805e92-b7fd-5c9b-adc8-2299569f56c2
 ```
 
+Upload HTML file from workstation.
+The name of the blog post will be derived from the file name.
 ```shell
-# Upload HTML file from workstation.
-# The name of the blog post will be derived from the file name.
 hstw upload testdrive.html
 ```
+
+Upload PNG image from workstation to folder path on hubfs.
 ```shell
-# Upload PNG image from workstation to folder path on hubfs.
 hstw upload testdrive.png --folder-path=/foo/bar
 ```
 
+Convert Markdown to HTML, upload the document under a different name, and also upload all
+referenced images.
+```shell
+hstw upload /path/to/document.md --name=a-different-name --folder-path=/blog/2023/topic
+```
+
 For more detailed information about this feature, please refer to the inline help:
 ```shell
 hstw upload --help

docs/backlog.md

@@ -10,6 +10,7 @@
   - Use HubSpot title from Markdown
   - Remove MyST specialities, e.g. `(full-text)=`
 - File bug: Uploading/updating blog post via identifier does not work
+- Don't upload files over and over again
 - Release 0.1.0
 
 ### Documentation
@@ -53,6 +54,10 @@
 - https://observablehq.com/@observablehq/introduction-to-ai-assist
 - https://observablehq.com/blog/improving-ai-assist
 
+### write freely
+- https://writefreely.org/
+- https://github.com/writefreely/writefreely
+
 
 ## Done
 - Permalinks for headers

hubspot_tech_writing/cli.py

@@ -176,13 +176,13 @@ def linkcheck_cli(source: str):
     "--folder-id",
     type=str,
     required=False,
-    help="The folder id for storing files. Needed when creating a file item. Alternatively, use folder name.",
+    help="The folder id for storing files. Alternatively, use folder name.",
 )
 @click.option(
     "--folder-path",
     type=str,
     required=False,
-    help="The folder path for storing files. Needed when creating a file item. Alternatively, use folder id.",
+    help="The folder path for storing files. Alternatively, use folder id.",
 )
 @access_token_option
 def upload_cli(access_token: str, source: str, name: str, content_group_id: str, folder_id: str, folder_path: str):