fixing broken references in documentation and removing unicode emojis from doc gen

Author: dcinzona

.github/release.yml

@@ -7,16 +7,16 @@ changelog:
         authors:
             - app/github-actions
     categories:
-        - title: Critical Changes 🛠
+        - title: Critical Changes
           labels:
               - critical-change
-        - title: Changes 🎉
+        - title: Changes
           labels:
               - enhancement
               - "*"
           exclude:
               labels:
                   - bug
-        - title: Issues Fixed 🩴
+        - title: Issues Fixed
           labels:
               - bug

cumulusci/tasks/release_notes/task.py

@@ -141,7 +141,7 @@ class ParentPullRequestNotes(BaseGithubTask):
 
     If you have a pull request on branch feature/myFeature that you would like to rebuild notes
     for use the branch_name and force options:
-        cci task run github_parent_pr_notes --branch-name feature/myFeature --force True
+    - cci task run github_parent_pr_notes --branch-name feature/myFeature --force True
     """
     UNAGGREGATED_PR_HEADER = "\r\n\r\n# Unaggregated Pull Requests"
 

docs/conf.py

@@ -222,6 +222,8 @@
 # This is the file name suffix for HTML files (e.g. ".xhtml").
 # html_file_suffix = None
 
+suppress_warnings = ["ref.duplicate_label"]
+
 # Output file base name for HTML help builder.
 htmlhelp_basename = "cumuluscidoc"
 
@@ -231,14 +233,11 @@
 
 
 latex_elements = {
-    # The paper size ('letterpaper' or 'a4paper').
-    # 'papersize': 'letterpaper',
-    # The font size ('10pt', '11pt' or '12pt').
-    # 'pointsize': '10pt',
-    # Additional stuff for the LaTeX preamble.
-    # 'preamble': '',
+    'preamble': r'''\renewcommand{\familydefault}{\sfdefault}  % Set default font to sans-serif
+''',
 }
 
+
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
@@ -247,13 +246,12 @@
         "index",
         "cumulusci.tex",
         "CumulusCI Documentation",
-        """Kamalnath Devarakonda\\\\
-Sr Director Software Engineering\\\\
-kdevarakonda@salesforce.com""",
+        r'Cumulus Suite Development Team\\\texttt{sfdo-mrbelvedere@salesforce.com}',
         "manual",
     )
 ]
 
+exclude_patterns = ['history.md']  # Ensures history.md is excluded
 # The name of an image file (relative to this directory) to place at
 # the top of the title page.
 # latex_logo = None

docs/config.md

@@ -723,7 +723,7 @@ in your cumulusci.yml file.
 
 ### Customizing Metadata Deployment
 
-CumulusCI's `deploy` task offers deep flexibility to customize your deployment process. Review [](deploy) for an in-depth guide.
+CumulusCI's `deploy` task offers deep flexibility to customize your deployment process. Review [](configure-metadata-deployment) for an in-depth guide.
 
 ```{toctree}
 ---

docs/connected-orgs.md

@@ -66,25 +66,25 @@ CumulusCI with the name `devhub`.
 ```console
 $ cci org list
 
-┌Scratch Orgs──────────────┬─────────┬──────┬─────────┬──────────────┬────────┐
+                                  Scratch Orgs 
 │ Name                     │ Default │ Days │ Expired │ Config       │ Domain │
-├──────────────────────────┼─────────┼──────┼─────────┼──────────────┼────────┤
+├──────────────────────────|─────────|──────|─────────|──────────────|────────-|
 │ dev                      │         │ 7    │ X       | dev          │        │
-├──────────────────────────┼─────────┼──────┼─────────┼──────────────┼────────┤
+├──────────────────────────|─────────|──────|─────────|──────────────|────────-|
 │ feature                  │         │ 1    │ X       | feature      │        │
-├──────────────────────────┼─────────┼──────┼─────────┼──────────────┼────────┤
+├──────────────────────────|─────────|──────|─────────|──────────────|────────-|
 │ prerelease               │         │ 1    │ X       | prerelease   │        │
-├──────────────────────────┼─────────┼──────┼─────────┼──────────────┼────────┤
+├──────────────────────────|─────────|──────|─────────|──────────────|────────-|
 │ qa                       │         │ 7    │ X       | qa           │        │
-├──────────────────────────┼─────────┼──────┼─────────┼──────────────┼────────┤
+├──────────────────────────|─────────|──────|─────────|──────────────|────────-|
 │ release                  │         │ 1    │ X       | release      │        │
-└──────────────────────────┴─────────┴──────┴─────────┴──────────────┴────────┘
 
-┌Connected Orgs────┬──────────────────────────────┬────────────┐
+
+                         Connected Orgs
 │ Name   │ Default │ Username                     │ Expires    │
-├────────┼─────────┼──────────────────────────────┼────────────┤
+├────────|─────────|──────────────────────────────|────────────-|
 │ devhub │         │ j.holt@mydomain.devhub       │ Persistent │
-└────────┴─────────┴──────────────────────────────┴────────────┘
+
 ```
 
 Verify a successful connection to the org by logging in.

docs/data/extract_declarations.md

@@ -11,7 +11,7 @@ generated by `capture_sample_data` or by Metecho.
 
 An extract declaration looks like this:
 
-```yml
+```yaml
 extract:
     Opportunity:
         fields:
@@ -27,7 +27,7 @@ and Account.
 
 That declaration is therefore the same as:
 
-```yml
+```yaml
 # This will download the Salesforce-y trinity
 # of Accounts, Contacts and Opportunities
 extract:

docs/deploy.md

@@ -1,3 +1,4 @@
+(configure-metadata-deployment)=
 # Configure Metadata Deployment
 
 CumulusCI's `deploy` task uses the Metadata API to deploy metadata from the repository to a Salesforce org. `deploy` offers multiple sophisticated capabilities to suit the needs of your project.
@@ -62,7 +63,7 @@ flows:
                                 replace: bar
 ```
 
-To learn more about customization, see [](config). To discover the available transform options, consult the section for each transform in [](deploy).
+To learn more about customization, see [](config). To discover the available transform options, consult the section for each transform in [](configure-metadata-deployment).
 
 ### Namespace Injection
 

docs/dev.md

@@ -161,15 +161,15 @@ editor, push these changes from your project's local repository to the
 target org.
 
 To push your changes, use the
-[](deploy) task:
+[deploy](configure-metadata-deployment) task:
 
 ```console
 $ cci task run deploy
 ```
 
 The `deploy` task has _many_ options for handling a number of different
 scenarios. For a comprehensive list of options, see the
-[](deploy) task reference.
+[deploy](configure-metadata-deployment) task reference.
 
 ## Run Apex Tests