diff --git a/404.html b/404.html index 9729b23..2bc3d60 100644 --- a/404.html +++ b/404.html @@ -4,7 +4,7 @@ - + @@ -29,11 +29,11 @@ - + - + - + diff --git a/about/index.html b/about/index.html index cd1bc7e..0e51a93 100644 --- a/about/index.html +++ b/about/index.html @@ -4,7 +4,7 @@ - + @@ -32,11 +32,11 @@ - + - + - + @@ -260,6 +260,6 @@

- + diff --git a/backend/domain-event-propagation/index.html b/backend/domain-event-propagation/index.html index 276ad08..b37daf9 100644 --- a/backend/domain-event-propagation/index.html +++ b/backend/domain-event-propagation/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/backend/mediatr-extensions/index.html b/backend/mediatr-extensions/index.html index 8eee302..e961e02 100644 --- a/backend/mediatr-extensions/index.html +++ b/backend/mediatr-extensions/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/backend/mongo-extensions/index.html b/backend/mongo-extensions/index.html index 698b2c8..2fcc550 100644 --- a/backend/mongo-extensions/index.html +++ b/backend/mongo-extensions/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/frontend/foundry-cli/index.html b/frontend/foundry-cli/index.html index 43cb93b..8f6b505 100644 --- a/frontend/foundry-cli/index.html +++ b/frontend/foundry-cli/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/frontend/hopper/index.html b/frontend/hopper/index.html index 72e1bdb..cf1a98b 100644 --- a/frontend/hopper/index.html +++ b/frontend/hopper/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/frontend/squide/index.html b/frontend/squide/index.html index b55f4bd..52636f9 100644 --- a/frontend/squide/index.html +++ b/frontend/squide/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/frontend/web-configs/index.html b/frontend/web-configs/index.html index 31f4376..e203e5a 100644 --- a/frontend/web-configs/index.html +++ b/frontend/web-configs/index.html @@ -4,7 +4,7 @@ - + @@ -30,11 +30,11 @@ - + - + - + @@ -60,6 +60,6 @@
- + diff --git a/index.html b/index.html index 2003b1c..1a45527 100644 --- a/index.html +++ b/index.html @@ -4,7 +4,7 @@ - + @@ -34,11 +34,11 @@ - + - + - + @@ -260,6 +260,6 @@

- + diff --git a/joining-the-hub/index.html b/joining-the-hub/index.html index 2854f5f..1dd7144 100644 --- a/joining-the-hub/index.html +++ b/joining-the-hub/index.html @@ -4,7 +4,7 @@ - + @@ -32,12 +32,12 @@ - + - + - - + + @@ -277,7 +277,7 @@

Try it 🚀

-

Start your Retype site by executing the dev-docs script.

+

Start your new Retype site by executing the dev-docs script.

# @@ -526,6 +526,9 @@

enabled: true home: false +toc: + depth: 2 + hub: link: https://gsoft-inc.github.io/wl-idp-docs-hub/ alt: Workleap's IDP homepage @@ -647,6 +650,6 @@

- + diff --git a/resources/js/config.js b/resources/js/config.js index e7b076b..24960d5 100644 --- a/resources/js/config.js +++ b/resources/js/config.js @@ -1 +1 @@ -var __DOCS_CONFIG__ = {"id":"sYowRH2dc4QJCOVwJsl3/yxJorYU47pwZ4","key":"Ym8mfErxahRx5meA24bPUovjAESJ1Rqeidi8T5eMkAM.rq8OBjqMgEf4Uw+AhB9xiz1TKfXFilwEZBBdbPu12QsHzbW7+15e29tFsJRbz0bXH+BE7UoJUiMiaoyMGRhAvw.300075","base":"/wl-idp-docs-hub/","host":"gsoft-inc.github.io","version":"1.0.0","useRelativePaths":true,"documentName":"index.html","appendDocumentName":false,"trailingSlash":true,"preloadSearch":false,"cacheBustingToken":"3.5.0.749103795121","cacheBustingStrategy":"query","sidebarFilterPlaceholder":"Filter","toolbarFilterPlaceholder":"Filter","showSidebarFilter":true,"filterNotFoundMsg":"No member names found containing the query \"{query}\"","maxHistoryItems":15,"homeIcon":"","access":[{"value":"public","label":"Public"},{"value":"protected","label":"Protected"}],"toolbarLinks":[{"id":"fields","label":"Fields"},{"id":"properties","label":"Properties"},{"id":"methods","label":"Methods"},{"id":"events","label":"Events"}],"sidebar":[{"n":"/","l":"Workleap Internal Developer Platform (IDP)","v":false},{"n":"joining-the-hub","l":"Joining the hub","s":""},{"n":"frontend","l":"Frontend libraries","c":false,"o":true,"i":[{"n":"foundry-cli","u":"https://github.com/gsoft-inc/wl-foundry-cli","l":"Foundry CLI"},{"n":"web-configs","u":"https://gsoft-inc.github.io/wl-web-configs","l":"Web configs"},{"n":"squide","u":"https://gsoft-inc.github.io/wl-squide","l":"Squide"},{"n":"hopper","u":"https://hopper.workleap.design","l":"Hopper"}],"s":""},{"n":"backend","l":"Backend libraries","c":false,"o":true,"i":[{"n":"domain-event-propagation","u":"https://github.com/gsoft-inc/wl-domain-event-propagation","l":"Domain event propagation"},{"n":"mediatr-extensions","u":"https://github.com/gsoft-inc/wl-extensions-mediatr","l":"Mediatr extensions"},{"n":"mongo-extensions","u":"https://github.com/gsoft-inc/wl-extensions-mongo","l":"Mongo extensions"}],"s":""},{"n":"why-retype","l":"Why Retype?","s":""},{"n":"about","l":"About","v":false}],"search":{"mode":0,"minChars":2,"maxResults":20,"placeholder":"Search","hotkeys":["k"],"noResultsFoundMsg":"Sorry, no results found.","recognizeLanguages":true,"languages":[0],"preload":false},"resources":{"History_Title_Label":"History","History_ClearLink_Label":"Clear","History_NoHistory_Label":"No history items","API_AccessFilter_Label":"Access","API_ParameterSection_Label":"PARAMETERS","API_SignatureSection_Label":"SIGNATURE","API_CopyHint_Label":"Copy","API_CopyNameHint_Label":"Copy name","API_CopyLinkHint_Label":"Copy link","API_CopiedAckHint_Label":"Copied!","API_MoreOverloads_Label":"more","API_MoreDropdownItems_Label":"More","API_OptionalParameter_Label":"optional","API_DefaultParameterValue_Label":"Default value","API_InheritedFilter_Label":"Inherited","Search_Input_Placeholder":"Search","Toc_Contents_Label":"Contents","Toc_RelatedClasses_Label":"Related Classes","History_JustNowTime_Label":"just now","History_AgoTime_Label":"ago","History_YearTime_Label":"y","History_MonthTime_Label":"mo","History_DayTime_Label":"d","History_HourTime_Label":"h","History_MinuteTime_Label":"m","History_SecondTime_Label":"s"}}; +var __DOCS_CONFIG__ = {"id":"NrZYSNGS47di435ZCzlL5Ip+2gPB+xktg1","key":"1t9KfCsWW57mV64iayOyPDAObIg8k0kHW0oFqD2RHZQ.OiNF2H1qTvQoCZEw1buZjk6uijH/pJ/tG9ZqieLOdUlGPysmQMdi+TbyTt/+oVkzIyzPi0wxs/OA+zpIvlmg/Q.300065","base":"/wl-idp-docs-hub/","host":"gsoft-inc.github.io","version":"1.0.0","useRelativePaths":true,"documentName":"index.html","appendDocumentName":false,"trailingSlash":true,"preloadSearch":false,"cacheBustingToken":"3.5.0.749144935904","cacheBustingStrategy":"query","sidebarFilterPlaceholder":"Filter","toolbarFilterPlaceholder":"Filter","showSidebarFilter":true,"filterNotFoundMsg":"No member names found containing the query \"{query}\"","maxHistoryItems":15,"homeIcon":"","access":[{"value":"public","label":"Public"},{"value":"protected","label":"Protected"}],"toolbarLinks":[{"id":"fields","label":"Fields"},{"id":"properties","label":"Properties"},{"id":"methods","label":"Methods"},{"id":"events","label":"Events"}],"sidebar":[{"n":"/","l":"Workleap Internal Developer Platform (IDP)","v":false},{"n":"joining-the-hub","l":"Joining the hub","s":""},{"n":"frontend","l":"Frontend libraries","c":false,"o":true,"i":[{"n":"foundry-cli","u":"https://github.com/gsoft-inc/wl-foundry-cli","l":"Foundry CLI"},{"n":"web-configs","u":"https://gsoft-inc.github.io/wl-web-configs","l":"Web configs"},{"n":"squide","u":"https://gsoft-inc.github.io/wl-squide","l":"Squide"},{"n":"hopper","u":"https://hopper.workleap.design","l":"Hopper"}],"s":""},{"n":"backend","l":"Backend libraries","c":false,"o":true,"i":[{"n":"domain-event-propagation","u":"https://github.com/gsoft-inc/wl-domain-event-propagation","l":"Domain event propagation"},{"n":"mediatr-extensions","u":"https://github.com/gsoft-inc/wl-extensions-mediatr","l":"Mediatr extensions"},{"n":"mongo-extensions","u":"https://github.com/gsoft-inc/wl-extensions-mongo","l":"Mongo extensions"}],"s":""},{"n":"why-retype","l":"Why Retype?","s":""},{"n":"about","l":"About","v":false}],"search":{"mode":0,"minChars":2,"maxResults":20,"placeholder":"Search","hotkeys":["k"],"noResultsFoundMsg":"Sorry, no results found.","recognizeLanguages":true,"languages":[0],"preload":false},"resources":{"History_Title_Label":"History","History_ClearLink_Label":"Clear","History_NoHistory_Label":"No history items","API_AccessFilter_Label":"Access","API_ParameterSection_Label":"PARAMETERS","API_SignatureSection_Label":"SIGNATURE","API_CopyHint_Label":"Copy","API_CopyNameHint_Label":"Copy name","API_CopyLinkHint_Label":"Copy link","API_CopiedAckHint_Label":"Copied!","API_MoreOverloads_Label":"more","API_MoreDropdownItems_Label":"More","API_OptionalParameter_Label":"optional","API_DefaultParameterValue_Label":"Default value","API_InheritedFilter_Label":"Inherited","Search_Input_Placeholder":"Search","Toc_Contents_Label":"Contents","Toc_RelatedClasses_Label":"Related Classes","History_JustNowTime_Label":"just now","History_AgoTime_Label":"ago","History_YearTime_Label":"y","History_MonthTime_Label":"mo","History_DayTime_Label":"d","History_HourTime_Label":"h","History_MinuteTime_Label":"m","History_SecondTime_Label":"s"}}; diff --git a/resources/js/search.json b/resources/js/search.json index 71a33c7..da869d1 100644 --- a/resources/js/search.json +++ b/resources/js/search.json @@ -1 +1 @@ -[[{"i":"workleap-internal-developer-platform-idp","l":"Workleap Internal Developer Platform (IDP)","p":["Welcome to the documentation hub for Workleap IDP libraries. On this site, you'll discover a variety of libraries that collectively constitutes the internal developer platform for creating applications on the Workleap platform."]}],[{"l":"Joining the hub","p":["To include your library documentation in Workleap's IDP hub, follow these steps."]},{"l":"Create your Retype website","p":["First, navigate to the Retype getting started guide to set up a Retype website within your library repository."]},{"l":"Basic setup","p":["Then, open the retype.yml file located at the root of the repository and copy/paste the following basic configuration:","Finally, add the following script to your package.json file:","Please note that Retype is also compatible with .NET projects. If you are working on a .NET project, visit the Retype website for guidance on starting your Retype development."]},{"i":"try-it","l":"Try it \uD83D\uDE80","p":["Start your Retype site by executing the dev-docs script."]},{"i":"adhere-to-workleaps-conventions","l":"Adhere to Workleap's conventions","p":["The following conventions are optional but highly recommend to to guarantee a consistent and unified experience for Workleap's developers within the Workleap IDP hub."]},{"l":"Icons","p":["First, add Workleap's reversed bleu logo and favicon to the /docs/static folder:","Then, configure Retype to use the new assets by including the following configurations to your retype.yml file:"]},{"l":"Top bar links","p":["A link to a page listing your library releases.","A link to request a new feature for your library.","A link to the homepage of your Retype site.","A link to the library's packages.","A link to your library's bug tracker.","A link to your library's repository.","Description","Feature requests","Found a bug","GitHub (or another platform)","Home","Link","NPM / Nugget","Releases","Then, add the following links to the top nav bar of your Retype site:","Your Retype links configuration should closely resemble the following configurations"]},{"l":"Footer links","p":["Then, add the following links to the footer of your Retype site:","Link","Description","About","A link to an about page including meta informations about your library project ( example).","License","A link to the license of your library.","Your Retype footer links configuration should closely resemble the following configurations"]},{"l":"Retype navigation folder items","p":["We recommend adding an icon before each folder item of the main navigation (on the left):","Icon","Section","Use a rocket icon for a \"Getting Started\" section ( example).","Use a book icon for a \"Guides\" section ( example).","Use a gear icon for a \"Reference\" section ( example).","Use a question icon for a \"Troubleshooting\" section ( example).","Use a command-palette icon for a \"Sample\" section ( example)."]},{"l":"Include the shared CSS customizations file","p":["Our Retype websites share a CSS file that contains several customizations to enhance the default Retype style. To incorporate this file into your Retype site, follow these steps:"]},{"i":"create-the-_includesheadhtml-file","l":"Create the _includes/head.html file","p":["Create a _includes/head.html file within the /docs folder:"]},{"l":"Link the shared CSS file","p":["Then, open the newly created _includes/head.html file and copy/paste the following content:"]},{"l":"Activate pro features","p":["Workleap has acquired an Enterprise license for Retype, which you can locate the key in our secure Vault. To enable Retype's pro features, copy and paste the following configuration into your retype.yml file:"]},{"l":"Configure your Retype wallet","p":["Since we've added the following lines to your retype.yml file:","You can now develop a Retype site locally with the pro features without the need for a local Retype wallet. However, if you prefer to set up your local Retype wallet, follow these steps:","Locate the Retype license key in our secure Vault.","Utilize the Retype CLI to create your wallet."]},{"l":"Host your site on GitHub pages","p":["To use our Retype enterprise license, and for every hub features of Retype to work properly, the site must be hosted on the https://gsoft-inc.github.io domain. As this is a GitHub Pages domain, to join the hub, your Retype site must be deployed with GitHub Pages.","To configure your Retype site to be deployed with GitHub Pages, refer to the following guide.","You don't need to set the Retype Enterprise license key as it's already configured as an organization secret."]},{"l":"Add your site to the hub","p":["Send a PR to the wl-idp-docs-hub GitHub repository to add your site to the hub. Once merged, your site will be automatically added to the Workleap IDP hub!"]}],[],[],[],[],[],[],[],[{"i":"why-retype","l":"Why Retype?"},{"l":"Comparison with GitHub readme files","p":["While GitHub README.md files are great, there are several compelling reasons to consider using a documentation platform like Retype:","Better Structuring: Retype simplifies the organization of documentation by allowing easy division into multiple files and provides an intuitive navigation system with a left sidebar for seamless browsing.","Automatic Table of Contents: Retype generates an in-page Table of Contents automatically from the page's headers, improving navigation within the documentation.","Powerful Search: Retype integrates advanced content search functionality, enabling developers to quickly locate the information they need.","Broken Link Detection: Retype's compilers swiftly identify any broken links (including anchors), ensuring that your documentation remains error-free.","Retype's compiler warning","Advanced Code Block Features: Retype's code blocks support features like line highlighting and optional titles, enhancing the presentation of code samples.","Rich components collection: Retype offers out of the box a rich collection of markdown components that should meet the requirements of most documentation websites.","Outbound Links: Retype automatically identifies and manages external (outbound) links within the project, opening them in new tabs when clicked for a smoother user experience.","Multiple Layouts: Retype offers three distinct layouts out of the box: page, central, and blog, allowing flexibility in presentation.","Custom CSS: Retype allows to add custom global CSS and CSS classes to containers.","The Hub Functionality: Retype's hub functionality enables the interlinking of multiple websites, facilitating seamless navigation between related resources.","By choosing Retype, we can take advantage of these features to enhance our documentation's organization, accessibility, and overall developers experience."]},{"l":"Comparison with other documentation platforms","p":["When considering documentation platforms, it's essential to explore alternatives to Retype. Several options exist, including SaaS-based solutions like Gitbook and self-hosted options like Docusaurus, Rspress, or even creating a custom website using Next.js."]},{"l":"SaaS-based platforms","p":["SaaS-based platforms like Gitbook offer convenience but can fall short in terms of customization and often come with complex pricing structures, particularly when managing a collection of libraries like Workleap's IDP."]},{"l":"Self-hosted platforms","p":["Self-hosted platforms like Docusaurus can match Retype's feature set but tend to have a higher entry barrier. Each website created with Docusaurus is entirely custom and involves frontend tooling. The entry barrier increases significantly because developers must possess knowledge of how frontend tools operate and how to build a React application.","One of Retype's strengths lies in its balance between customization and ease of entry. It provides just enough customization to create rich and personalized documentation while maintaining a very low entry barrier. Basic knowledge of markdown is all that's needed to get started.","High-level solution structure of a Docusaurus website:","High-level solution structure of a Retype website:","In summary, platforms like Docusaurus demand frontend expertise to write documentation effectively, while Retype only requires a basic understanding of markdown. Retype functions as a command-line interface (CLI) that compiles markdown files into a website, making it adaptable even within a .NET repository since it supports the .NET platform."]},{"i":"net-support","l":".NET support","p":["Retype fully supports the .NET platform, making it a seamless choice for .NET developers:","With Retype's .NET support, creating documentation for an IDP backend library becomes straightforward. All you need to do is include a docs folder at the root of your repository, and Retype will handle the rest:"]}],[{"l":"About","p":["To ask a question or propose an idea, feel free to start a new discussion on Github. If you found a bug, please open an issue on Github."]},{"l":"License","p":["See the LICENSE on Github."]}]] \ No newline at end of file +[[{"i":"workleap-internal-developer-platform-idp","l":"Workleap Internal Developer Platform (IDP)","p":["Welcome to the documentation hub for Workleap IDP libraries. On this site, you'll discover a variety of libraries that collectively constitutes the internal developer platform for creating applications on the Workleap platform."]}],[{"l":"Joining the hub","p":["To include your library documentation in Workleap's IDP hub, follow these steps."]},{"l":"Create your Retype website","p":["First, navigate to the Retype getting started guide to set up a Retype website within your library repository."]},{"l":"Basic setup","p":["Then, open the retype.yml file located at the root of the repository and copy/paste the following basic configuration:","Finally, add the following script to your package.json file:","Please note that Retype is also compatible with .NET projects. If you are working on a .NET project, visit the Retype website for guidance on starting your Retype development."]},{"i":"try-it","l":"Try it \uD83D\uDE80","p":["Start your new Retype site by executing the dev-docs script."]},{"i":"adhere-to-workleaps-conventions","l":"Adhere to Workleap's conventions","p":["The following conventions are optional but highly recommend to to guarantee a consistent and unified experience for Workleap's developers within the Workleap IDP hub."]},{"l":"Icons","p":["First, add Workleap's reversed bleu logo and favicon to the /docs/static folder:","Then, configure Retype to use the new assets by including the following configurations to your retype.yml file:"]},{"l":"Top bar links","p":["A link to a page listing your library releases.","A link to request a new feature for your library.","A link to the homepage of your Retype site.","A link to the library's packages.","A link to your library's bug tracker.","A link to your library's repository.","Description","Feature requests","Found a bug","GitHub (or another platform)","Home","Link","NPM / Nugget","Releases","Then, add the following links to the top nav bar of your Retype site:","Your Retype links configuration should closely resemble the following configurations"]},{"l":"Footer links","p":["Then, add the following links to the footer of your Retype site:","Link","Description","About","A link to an about page including meta informations about your library project ( example).","License","A link to the license of your library.","Your Retype footer links configuration should closely resemble the following configurations"]},{"l":"Retype navigation folder items","p":["We recommend adding an icon before each folder item of the main navigation (on the left):","Icon","Section","Use a rocket icon for a \"Getting Started\" section ( example).","Use a book icon for a \"Guides\" section ( example).","Use a gear icon for a \"Reference\" section ( example).","Use a question icon for a \"Troubleshooting\" section ( example).","Use a command-palette icon for a \"Sample\" section ( example)."]},{"l":"Include the shared CSS customizations file","p":["Our Retype websites share a CSS file that contains several customizations to enhance the default Retype style. To incorporate this file into your Retype site, follow these steps:"]},{"i":"create-the-_includesheadhtml-file","l":"Create the _includes/head.html file","p":["Create a _includes/head.html file within the /docs folder:"]},{"l":"Link the shared CSS file","p":["Then, open the newly created _includes/head.html file and copy/paste the following content:"]},{"l":"Activate pro features","p":["Workleap has acquired an Enterprise license for Retype, which you can locate the key in our secure Vault. To enable Retype's pro features, copy and paste the following configuration into your retype.yml file:"]},{"l":"Configure your Retype wallet","p":["Since we've added the following lines to your retype.yml file:","You can now develop a Retype site locally with the pro features without the need for a local Retype wallet. However, if you prefer to set up your local Retype wallet, follow these steps:","Locate the Retype license key in our secure Vault.","Utilize the Retype CLI to create your wallet."]},{"l":"Host your site on GitHub pages","p":["To use our Retype enterprise license, and for every hub features of Retype to work properly, the site must be hosted on the https://gsoft-inc.github.io domain. As this is a GitHub Pages domain, to join the hub, your Retype site must be deployed with GitHub Pages.","To configure your Retype site to be deployed with GitHub Pages, refer to the following guide.","You don't need to set the Retype Enterprise license key as it's already configured as an organization secret."]},{"l":"Add your site to the hub","p":["Send a PR to the wl-idp-docs-hub GitHub repository to add your site to the hub. Once merged, your site will be automatically added to the Workleap IDP hub!"]}],[],[],[],[],[],[],[],[{"i":"why-retype","l":"Why Retype?"},{"l":"Comparison with GitHub readme files","p":["While GitHub README.md files are great, there are several compelling reasons to consider using a documentation platform like Retype:","Better Structuring: Retype simplifies the organization of documentation by allowing easy division into multiple files and provides an intuitive navigation system with a left sidebar for seamless browsing.","Automatic Table of Contents: Retype generates an in-page Table of Contents automatically from the page's headers, improving navigation within the documentation.","Powerful Search: Retype integrates advanced content search functionality, enabling developers to quickly locate the information they need.","Broken Link Detection: Retype's compilers swiftly identify any broken links (including anchors), ensuring that your documentation remains error-free.","Retype's compiler warning","Advanced Code Block Features: Retype's code blocks support features like line highlighting and optional titles, enhancing the presentation of code samples.","Rich components collection: Retype offers out of the box a rich collection of markdown components that should meet the requirements of most documentation websites.","Outbound Links: Retype automatically identifies and manages external (outbound) links within the project, opening them in new tabs when clicked for a smoother user experience.","Multiple Layouts: Retype offers three distinct layouts out of the box: page, central, and blog, allowing flexibility in presentation.","Custom CSS: Retype allows to add custom global CSS and CSS classes to containers.","The Hub Functionality: Retype's hub functionality enables the interlinking of multiple websites, facilitating seamless navigation between related resources.","By choosing Retype, we can take advantage of these features to enhance our documentation's organization, accessibility, and overall developers experience."]},{"l":"Comparison with other documentation platforms","p":["When considering documentation platforms, it's essential to explore alternatives to Retype. Several options exist, including SaaS-based solutions like Gitbook and self-hosted options like Docusaurus, Rspress, or even creating a custom website using Next.js."]},{"l":"SaaS-based platforms","p":["SaaS-based platforms like Gitbook offer convenience but can fall short in terms of customization and often come with complex pricing structures, particularly when managing a collection of libraries like Workleap's IDP."]},{"l":"Self-hosted platforms","p":["Self-hosted platforms like Docusaurus can match Retype's feature set but tend to have a higher entry barrier. Each website created with Docusaurus is entirely custom and involves frontend tooling. The entry barrier increases significantly because developers must possess knowledge of how frontend tools operate and how to build a React application.","One of Retype's strengths lies in its balance between customization and ease of entry. It provides just enough customization to create rich and personalized documentation while maintaining a very low entry barrier. Basic knowledge of markdown is all that's needed to get started.","High-level solution structure of a Docusaurus website:","High-level solution structure of a Retype website:","In summary, platforms like Docusaurus demand frontend expertise to write documentation effectively, while Retype only requires a basic understanding of markdown. Retype functions as a command-line interface (CLI) that compiles markdown files into a website, making it adaptable even within a .NET repository since it supports the .NET platform."]},{"i":"net-support","l":".NET support","p":["Retype fully supports the .NET platform, making it a seamless choice for .NET developers:","With Retype's .NET support, creating documentation for an IDP backend library becomes straightforward. All you need to do is include a docs folder at the root of your repository, and Retype will handle the rest:"]}],[{"l":"About","p":["To ask a question or propose an idea, feel free to start a new discussion on Github. If you found a bug, please open an issue on Github."]},{"l":"License","p":["See the LICENSE on Github."]}]] \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index ffdfa33..0ba385d 100644 Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ diff --git a/why-retype/index.html b/why-retype/index.html index 42d78c6..e2e1e8d 100644 --- a/why-retype/index.html +++ b/why-retype/index.html @@ -4,7 +4,7 @@ - + @@ -34,12 +34,12 @@ - + - + - - + + @@ -382,6 +382,6 @@

- +