docs: enhance how references are generated (#5805)

* adjusted configurations

* enhancements to tool and configurations

* change reference in docs

* fixed issue in workflows reference

* added project name

* more optimizations

* fix context error

* added a types reference

* resolved missing types

* fix reference reflection types not having children

* add an expand url parameter

* added new option to the README

* added details about new option

www/apps/docs/content/upgrade-guides/medusa-core/1-7-0.md

@@ -4,11 +4,11 @@ description: 'Actions Required for v.1.7.0'
 
 # v1.7.0
 
-Version `1.7.0` of Medusa introduces a breaking change in the [CustomerService](../../references/services/classes/CustomerService.mdx).
+Version `1.7.0` of Medusa introduces a breaking change in the [CustomerService](../../references/services/classes/services.CustomerService.mdx).
 
 ## Overview
 
-In this new version, the method [`retrieveByEmail` in the Customer Service](../../references/services/classes/CustomerService.mdx#retrievebyemail) has been deprecated in favor of other methods. Read the actions required below to learn which methods to use instead.
+In this new version, the method [`retrieveByEmail` in the Customer Service](../../references/services/classes/services.CustomerService.mdx#retrievebyemail) has been deprecated in favor of other methods. Read the actions required below to learn which methods to use instead.
 
 In addition, after introducing the Claim Order feature, this version of Medusa introduces changes in the database that allows two customers having the same email based on the value of the `has_account` field. This change requires running migrations after the update.