feat: allow accessing documentation

fixes #128

docs/configuration_recipes.md

@@ -41,6 +41,44 @@ for i, label in ipairs(labels) do
         require("care").api.confirm()
     end)
 end
+
+```
+
+## Access Documentation
+
+You can use these function to access documentation. This e.g. allows to copy it
+to somewhere for reference or to click links in it easily.
+
+They have to be called while the documentation window of care is actually open.
+
+### Open in split
+
+This function opens the documentation in a split window.
+
+```lua
+local documentation = require("care").api.get_documentation()
+if #documentation == 0 then
+    return
+end
+local old_win = vim.api.nvim_get_current_win()
+vim.cmd.wincmd("s")
+local buf = vim.api.nvim_create_buf(false, true)
+vim.bo[buf].ft = "markdown"
+vim.api.nvim_buf_set_lines(buf, 0, -1, false, documentation)
+vim.api.nvim_win_set_buf(0, buf)
+vim.api.nvim_set_current_win(old_win)
+```
+
+### Copy to clipboard
+
+This function copies the documentation to the clipboard (or any other register).
+
+```lua
+local documentation = require("care").api.get_documentation()
+if #documentation == 0 then
+    return
+end
+vim.fn.setreg("+", table.concat(documentation, "\n"))
 ```
 
 ## Manual completion like builtin neovim

lua/care/init.lua

@@ -33,6 +33,11 @@ care.api = {
     doc_is_open = function()
         return care.core and care.core.menu and care.core.menu:docs_visible()
     end,
+    get_documentation = function()
+        return care.core.menu:docs_visible()
+                and vim.api.nvim_buf_get_lines(care.core.menu.docs_window.buf, 0, -1, false)
+            or {}
+    end,
     scroll_docs = function(delta)
         care.core.menu:scroll_docs(delta)
     end,