Migrate any documentation from atomic wiki into the core documentation

[joewiz]

From @dizzzz on eXist-open, referring to http://atomic.exist-db.org/HowTo/JettySSL:

that document is from 2008 ! it is probably outdated :-/ (classic issue with wikis)

[joewiz]

Does anyone have a list of the available atomic wiki articles that we could consider as candidates for inclusion in the documentation? (Unfortunately the list of articles in the "HowTo" section does not link to the articles.) :(

[duncdrum]

@joewiz is this still an issue?

[joewiz]

@duncdrum Yes, why do you ask? I was proposing that we consider articles such as http://atomic.exist-db.org/HowTo/JettySSL as candidates for inclusion in the eXist core documentation. Has that been folded in?

Or did you mean the atomicwiki link issue I mentioned in my 2nd post? I'm still unable to load the list of all "HowTo" articles. Loading http://atomic.exist-db.org/HowTo returns a message, "Either the feed is empty or you are not allowed to view the entries".

[dizzzz]

That SSL article is not relevant anymore as exist 3+ has the HTTPS port open by default,,,, mentioning that is it on port 8443 should be sufficient?

[duncdrum]

Ok then, here is a list of documentation candidates from the wiki (tick means that information in docs covers or supersedes the wiki article):

• How-To:
  • [x] OxygenXml
  • [ ] SQLDatabases
  • [x] Troubleshooting
  • [x] Wrapper
  • [x] XQTS
  • [x] XSLT2
  • [x] JettySSL
• Blogs:
  • [x] AkismetAPI
  • [x] AsirraAPi
  • [x] BasicAuthApps
  • [x] Captcha
  • [x] ConsistencyChecker
  • [x] ContentExtraction
  • [ ] EclipsePlugin
  • [x] H(igher)o(rder)F(unction)
  • [ ] InMemoryFragments (eXist 1.3)
  • [x] IntroducingXqueryRewrite
  • [x] JSON Serializer
  • [x] KWICSearch
  • [x] LuceneIndexModule
  • [x] NewIndexing
  • [x] NewRangeIndex
  • [x] NewXQuery3
  • [ ] Puppet
  • [x] RESTfulServices
  • [ ] TipsnTricks
  • [ ] WarningBadMemory (eXist 1.2.3)
  • [x] XQTS994
  • [x] XQuery3.1
  • [ ] XQueryDashboard
  • [x] XQueryMap
  • [ ] TravisCI
  • [x] FormValidation

@eriksiegel this might be of interest to you as well

[duncdrum]

@adamretter SQL, and the triplet of captcha akisnet, asirra articles are from you any thoughts if they should go into the docs?

@joewiz a number of articles have been moved some time ago, but I can find no trace of the decision process, so its possible that the ones that weren't, didn't make it into the docs for a reason.

@dizzzz some of this stuff seems to be your kind of thing (eclipse, tipsntricks?) any idea if and what should get moved

@JoernT FormValidation talks about ModelValidatorin the context of betterform, xform, etc is this still relevant? see eXist-db/exist#560

The only immediate candidate to me is the article on configuring TravisCI.

[xatapult]

@duncdrum I'll await the results of this discussion. When i have time left after doing what is now the core documentation I could pick up some of the articles for editing and inclusion.

[duncdrum]

Update for better legibility: @adamretter your wiki articles that need a vote:

• SQLDatabases see comment here
• AkismetAPI
• AsirraAPi
• Captcha
• Puppet

@dizzzz:

• TipsnTricks

@JoernT:

• FormValidation

other:

• EclipsePlugin
• TravisCI

[duncdrum]

see eXist-db/exist#1778

[adamretter]

@duncdrum these should stay on the Wiki as they are more example code:

1. AkismetAPI
2. AsirraAPi
3. Captcha

Where can I find the Puppet and SQL Databases articles to check?

[duncdrum]

@adamretter https://exist-db.org/exist/apps/wiki/HowTo/SQLDatabases/

[duncdrum]

Outstanding wiki articles: 5/33

• SQLDatabases
• Puppet
• TipsnTricks
• EclipsePlugin
• TravisCI

[joewiz]

@duncdrum By "outstanding" (in https://github.com/eXist-db/documentation/issues/102#issuecomment-389493850), these are the 5 remaining wiki articles that need to be adapted to the documentation, correct?

[duncdrum]

Yup

[line-o]

The connection to SQLDatabases was recently updated to allow pooling. Documenting that would be a great opportunity to get one step closer to closing this issue.

[adamretter]

Documenting that would be

@line-o Already documented - https://github.com/eXist-db/documentation/pull/608

[line-o]

Now that you said it :) I remember reviewing that. So ... is this issue still valid?