Generators.yml link, Update writing guide, add version numbers for sdks (#185)

Co-authored-by: Kapil Gowru <[email protected]>
Co-authored-by: Kapil Gowru <[email protected]>
Co-authored-by: Devin Logan <[email protected]>

Author: 4 people

README.md

@@ -49,21 +49,26 @@ Keep the following principles in mind:
 
 - **Write for your audience** - Consider why users are reading your documentation and explain the use case clearly. Focus on clarity and completeness without being verbose. Add examples and code snippets when relevant.
 - **Help users get something done**. Don't try to sell users on the product, and avoid marketing language like "amazing features" or "the best solution."
-- **Write in clear, concise language**, using [active voice](https://developers.google.com/style/voice) whenever possible. Keep sentences and paragraphs short and to the point. Use a friendly, casual tone and stay away from jargon as much as you can.
+- **Avoid time-specific language**. Don't mention a product or feature was just released or is the newest form, as this will quickly lead to stale documentation.
+- **Write in clear, concise language**, using [active voice](https://developers.google.com/style/voice) whenever possible. Keep sentences and paragraphs short and to the point. Be conversational and friendly tone. Stay away from jargon as much as you can.
 - **Use [Fern’s documentation components](https://buildwithfern.com/learn/docs/writing-content/components/overview)** whenever you can.
 - **When editing an existing page** - Match the existing heading structure, tone, and level of detail to ensure your changes integrate as seamlessly as possible.
 
-**For language and grammar help**, check out [Google's developer documentation style guide](https://developers.google.com/style) or Microsoft's [writing style guide](https://learn.microsoft.com/en-us/style-guide/welcome/)
+> "Break any of these rules sooner than say anything outright barbarous."
+> 
+> —George Orwell, "Politics and the English Language"
+
+Our style guide is influenced by [Google's developer documentation style guide](https://developers.google.com/style) and Microsoft's [writing style guide](https://learn.microsoft.com/en-us/style-guide/welcome/).
 
 ### Getting changes reviewed
 
 If you want to **add a new page or make a large structural change**:
-- [File an issue in GitHub](https://github.com/fern-api/docs/issues) and assign @devalog and @kgowru. We'll review your issue to make sure your proposed page fits with Fern's overall documentation strategy and isn't duplicating any ongoing work. 
+- [File an issue in GitHub](https://github.com/fern-api/docs/issues) and assign [@devalog](https://github.com/devalog), [@kgowru](https://github.com/kgowru), or [@dsinghvi](https://github.com/dsinghvi). We'll review your issue to make sure your proposed page fits with Fern's overall documentation strategy and isn't duplicating any ongoing work. 
 
 For **all other changes**:
 -  Submit a PR directly with your suggested changes. A Fern docs member will review and confirm.
 
-If you see something that is wrong or outdated in the documentation but don't know how to fix it, [file an issue](https://github.com/fern-api/docs/issues) or reach out to @devalog and @kgowru. 
+If you see something that is wrong or outdated in the documentation but don't know how to fix it, [file an issue](https://github.com/fern-api/docs/issues) or reach out to [@devalog](https://github.com/devalog), [@kgowru](https://github.com/kgowru), or [@dsinghvi](https://github.com/dsinghvi).
 
 
 

fern/assets/styles.css

@@ -43,6 +43,12 @@
     border-radius: 1.5rem !important;
   }
 
+  .product-dropdown-trigger {
+    svg {
+      transform: translateY(2px);
+    }
+  }
+
   .fern-product-selector {
     transform: translate(-2px, 2px);;
   }

fern/docs.yml

@@ -308,6 +308,10 @@ redirects:
     destination: /learn/sdks/overview/introduction
     permanent: true
 
+  - source: /learn/sdks/reference/generators-yml-reference
+    destination: /learn/sdks/reference/generators-yml
+    permanent: true
+
   # ============================================================================
   # DOCS REDIRECTS
   # ============================================================================

fern/products/sdks/fern-folder.mdx

@@ -82,7 +82,7 @@ published and configures customizations like package metadata, output locations,
 and generation settings.
 
 <Info>
-  See the [`generators.yml` reference page](/learn/sdks/reference/generators-yml-reference) for more information.
+  See the [`generators.yml` reference page](/sdks/reference/generators-yml) for more information.
 </Info>
 
 ## Configure Multiple APIs