[
https://issues.apache.org/jira/browse/FINERACT-2171?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18056815#comment-18056815
]
Aira Jena commented on FINERACT-2171:
-------------------------------------
I recommend Markdown for the MVP. GitHub Pages/Jekyll natively supports
Markdown (GFM/kramdown), so it builds cleanly with the default Pages workflow.
AsciiDoc in Jekyll relies on the jekyll-asciidoc/asciidoctor plugin, which
isn’t in the GitHub Pages dependency list, so the default build won’t process
.adoc. That means a custom build step to pre-render HTML, which adds complexity
for now. Plus slack messages are stored in a format called mrkdwn (Slack's
version of Markdown), I’ll do a quick spike to confirm: add a tiny .md and
.adoc page and check the Pages build logs. I’ll keep you posted.
Below are the links that I used:
https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll?utm_source=openai
https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll?utm_source=openai
https://www.rubydoc.info/gems/jekyll-asciidoc?utm_source=openai
https://docs.slack.dev/messaging/formatting-message-text/
Just rasied initial scaffold PR:
https://github.com/apache/fineract-chat-archive/pull/1
> make Slack messages discoverable by search engines
> --------------------------------------------------
>
> Key: FINERACT-2171
> URL: https://issues.apache.org/jira/browse/FINERACT-2171
> Project: Apache Fineract
> Issue Type: Wish
> Components: Docs
> Reporter: Adam Monsen
> Priority: Minor
> Attachments: FINERACT-2171-implementation-plan-v2.md,
> FINERACT-2171-implementation-plan.md, screenshot-1.png
>
>
> To improve discoverability of Fineract knowledge, lessons learned, and
> actions taken, let's automatically capture Slack messages and post them
> somewhere online/public/index-able.
> See also:
> [https://lists.apache.org/thread/rlqx239p10xt8w9odmh27ojto25r147w|https://lists.apache.org/thread/zf3zmblj96mqo9gl69tpgz5xorzxgw3z]
> Acceptance criteria suggestion: {*}a web search for, e.g. "mifos fineract
> mockito" returns relevant Slack messages{*}. A similar criteria should be
> useful for improving index-ability of issues, patches, mailing list messages,
> etc.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
