;;; tissue --- Text based issue tracker
;;; Copyright © 2022, 2023 Arun Isaac <arunisaac@systemreboot.net>
;;;
;;; This file is part of tissue.
;;;
;;; tissue is free software: you can redistribute it and/or modify it
;;; under the terms of the GNU General Public License as published by
;;; the Free Software Foundation, either version 3 of the License, or
;;; (at your option) any later version.
;;;
;;; tissue is distributed in the hope that it will be useful, but
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
;;; General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with tissue.  If not, see <https://www.gnu.org/licenses/>.

(document :title "tissue"
  (p [tissue is an issue tracker and project information management
system built on plain text files and git. It is specifically intended
for small free software projects. It features a static site generator
to build a project website and a powerful search interface to search
through project issues and documentation. The search interface is
built on the ,(ref :url "https://xapian.org/" :text "Xapian search
engine library"), and is available both as a command-line program and
as a web server.])
  (section :title "Feature highlights" :number #f
    (itemize
     (item [separation of discussion of issues from the documentation
of issues])
     (item [issues are gemtext files (one per issue) committed into
the project repository])
     (item [static site generator to build a project website])
     (item [powerful full text search engine powered by Xapian])
     (item [search through issues, documentation and even commit
messages])
     (item [all state is contained within the repository—nothing extra
to backup])
     (item [easy to host and does not require running large database
servers])))
  (section :title "Download" :number #f
    (p [Download release tarballs.])
    ;; TODO: Auto-generate this list from git tags.
    (itemize
     (item [2023-01-27 ,(ref :url "/releases/tissue-0.1.0.tar.lz"
:text "tissue-0.1.0.tar.lz") ,(ref :url
"/releases/tissue-0.1.0.tar.lz.asc" :text
"tissue-0.1.0.tar.lz.asc")]))
    (p [Download ,(ref :url
"https://systemreboot.net/about/arunisaac.pub" :text "public signing
key").])
    (p [Browse the tissue ,(ref :url
"https://git.systemreboot.net/tissue/" :text "git repository").]))
  (section :title "Documentation" :number #f
    (p [The ,(ref :url "/manual/dev/en/" :text "tissue manual") is
available online.])
    (p [We eat our own dog food too! Search through issues,
documentation and more using our own ,(ref :url "/search" :text
"self-hosted tissue instance").]))
  (section :title "Contributors" :number #f
    (p [Thanks to these wonderful people!])
    (description
     (item :key "Frederick Muriuki Muriithi"
           [code, ideas])
     (item :key "jgart"
           [ideas])
     (item :key "Morgan Smith"
           [bug reports, code])
     (item :key "Munyoki Kilyungi"
           [ideas])
     (item :key "Pjotr Prins"
           [code, ideas])))
  (section :title "License" :number #f
    (p [tissue is free software released under the terms of the ,(ref
:url "https://www.gnu.org/licenses/gpl.html" :text "GNU General Public
License"), either version 3 of the License, or (at your option) any
later version.])))