[Koha] Request for Listing a Paid Support Service Provider

[support]

Dear Koha Community,


I kindly request the addition of focuzinfotech.com to the list of paid
service providers on the Koha Community website. We are a company based
in Kerala, India, and specialize in offering a wide range of services
for Koha, including installation, customization, data migration,
support, training, and cloud hosting, catering to clients across all
regions. We are proud to have successfully implemented and provided
support to more than 300 + satisfied customers throughout India.

Company Name: focuzinfotech

Contact Person: Mr.Dixson Rodriges

Contact email: supp...@focuzinfotech.com

Website:   https://www.kohaforyou.com
  https://www.focuzinfotech.com
Telephone: +91 9249500540 , 0484-2805303


Thank you for considering our request.


-- 

Thank you & Regards,


Dixson Rodrigues 
Manager - IT Support & Service 
Focuz Infotech 
41/161, N H Bye Pass 
Edappally, Kochi - 682024 
Cell: +91-9249500540 
Phone: +91 484 2805303 
WhatsApp: +91-9249500540



___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

[Koha] Suggestion for a Debian Managed VPS

[Alessandro Tedesco]

Hello everyone,


I'm going to quit my old koha installation running on a Centos VPS and I
would like to switch to a new Debian VPS (so I can install and manage Koha
more easily).


However, I'm having a lot of difficulty choosing a hosting provider: in
fact, my old Centos VPS was Fully Managed (i mean that the Hosting Provider
take care of the general security, the update and the backup of the VPS,
and that they have a ticketing system for all the technical issues), but at
the moment I haven't found hosting provider that offer a Fully Managed VPS
with Debian.


Does anyone have any suggestions related to this topic? Thanks! Alessandro
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

Re: [Koha] Suggestion for a Debian Managed VPS

[David Liddle]

Hello Alessandro, it might be helpful to list the VPS providers that
you have rejected because of your criteria. It will make it easier for
people on the list to know whether or not to suggest the providers
they have in mind.

Have you already looked at EuroVPS (https://www.eurovps.com/debian-vps)?

Regards,

David Liddle
System Administrator
david.lid...@wycliff.de (but not for this list)

Wycliff e.V., https://wycliff.de
Seminar für Sprache und Kultur, https://spracheundkultur.org
Internationales Tagungszentrum Karimu, https://karimu.de


On Thu, Sep 7, 2023 at 11:25 AM Alessandro Tedesco
 wrote:
>
> Hello everyone,
>
>
> I'm going to quit my old koha installation running on a Centos VPS and I
> would like to switch to a new Debian VPS (so I can install and manage Koha
> more easily).
>
>
> However, I'm having a lot of difficulty choosing a hosting provider: in
> fact, my old Centos VPS was Fully Managed (i mean that the Hosting Provider
> take care of the general security, the update and the backup of the VPS,
> and that they have a ticketing system for all the technical issues), but at
> the moment I haven't found hosting provider that offer a Fully Managed VPS
> with Debian.
>
>
> Does anyone have any suggestions related to this topic? Thanks! Alessandro
> ___
>
> Koha mailing list  http://koha-community.org
> Koha@lists.katipo.co.nz
> Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

Re: [Koha] Staff Login Issues after updating OPAC to SSL

[David Liddle]

Hello Scott, Katrin is likely right about it being a configuration
issue with Apache. A command like the following, customized to suit
the domain you use, will list the configuration files that mention it:

grep -inr --include \*.conf 'example-library.org' /etc

Among those files will be one or more Apache configuration files and
the Koha sites configuration file, such as:

/etc/apache2/sites-available/library.conf
/etc/koha/koha-sites.conf

Depending on how your certificate was obtained and installed, you may
have more on the Apache side. You are welcome to pseudonymize and post
(or send) your Apache config for review and troubleshooting. (Maybe
the find and replace exercise will highlight an error.) I try to keep
ours as simple as possible. Double-check the port designations in the
Koha sites config, too. It's a little curious that you enabled HTTPS
on the OPAC but not on the staff interface.

Regards,

David Liddle
System Administrator
david.lid...@wycliff.de (but not for this list)

Wycliff e.V., https://wycliff.de
Seminar für Sprache und Kultur, https://spracheundkultur.org
Internationales Tagungszentrum Karimu, https://karimu.de


On Wed, Aug 30, 2023 at 11:23 PM Scott Marriott  wrote:
>
> We recently updated our OPAC to use SSL. The problem we're now having it
> that when we log into our staff interface using our old http://
> koha.com:8080 site we're getting and error messages and every time we move
> to another link on the site it's going back to the login screen and
> requiring us to login again, before continuing on to the correct link.
>
> Any suggestions where to check first? (I'm not seeing anything in the Koha
> log files.
>
> Thank You, Scott
>
> Scott Marriott
> Emerson
> ___
>
> Koha mailing list  http://koha-community.org
> Koha@lists.katipo.co.nz
> Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

Re: [Koha] Suggestion for a Debian Managed VPS

[Alessandro Tedesco]

Hello David,

thank you for your reply! I will take a look at the Hostin Provider that
you have suggested. Alessandro

Il giorno gio 7 set 2023 alle ore 12:07 David Liddle  ha
scritto:

> Hello Alessandro, it might be helpful to list the VPS providers that
> you have rejected because of your criteria. It will make it easier for
> people on the list to know whether or not to suggest the providers
> they have in mind.
>
> Have you already looked at EuroVPS (https://www.eurovps.com/debian-vps)?
>
> Regards,
>
> David Liddle
> System Administrator
> david.lid...@wycliff.de (but not for this list)
>
> Wycliff e.V., https://wycliff.de
> Seminar für Sprache und Kultur, https://spracheundkultur.org
> Internationales Tagungszentrum Karimu, https://karimu.de
>
>
> On Thu, Sep 7, 2023 at 11:25 AM Alessandro Tedesco
>  wrote:
> >
> > Hello everyone,
> >
> >
> > I'm going to quit my old koha installation running on a Centos VPS and I
> > would like to switch to a new Debian VPS (so I can install and manage
> Koha
> > more easily).
> >
> >
> > However, I'm having a lot of difficulty choosing a hosting provider: in
> > fact, my old Centos VPS was Fully Managed (i mean that the Hosting
> Provider
> > take care of the general security, the update and the backup of the VPS,
> > and that they have a ticketing system for all the technical issues), but
> at
> > the moment I haven't found hosting provider that offer a Fully Managed
> VPS
> > with Debian.
> >
> >
> > Does anyone have any suggestions related to this topic? Thanks!
> Alessandro
> > ___
> >
> > Koha mailing list  http://koha-community.org
> > Koha@lists.katipo.co.nz
> > Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha
> ___
>
> Koha mailing list  http://koha-community.org
> Koha@lists.katipo.co.nz
> Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha
>
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

[Koha] koha-plugin-room-reservations-3.2.3

[Sami M. Rasheed]

Hi,
I have Koha 23.05.03, I uploaded "koha-plugin-room-reservations-3.2.3.kpz". 
The issue is that the calendar always shows the following month, and the 
reservations are not shown there.

 I double-checked the Ubuntu operating system's time and date (V. 22.04), and 
everything is correct.

Thanks.
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

[Koha] The "one manual" idea

[Charillon, Aude]

Hello,

In the Koha Documentation team, we have been discussing whether we
still need one version of the manual per Koha version. The idea being
mooted is that having only one manual for all versions in the future
may be better.

It's an idea that is still at the exploration stage; at this point we
would like to get feedback from a wider group of people, hence this
message! I included further down a summary of what has been raised so
far. We are particularly interested in your thoughts on the following:

- What would be impacted if we decided to move to one manual - that we
haven't considered yet (see summary)? What issues may arise, who would
they affect, what are your suggestions to solve them?
- Are there any specific considerations for translated versions of the manual?
- Are there any technical considerations that us non-developers
haven't thought of?

If you have questions, concerns or just think it's a good idea, it
would also be nice to hear from you :-)

Thanks,

Aude [aude_c on Koha IRC]
Documentation Manager for the 23.11 cycle


Issues with the current situation
- The documentation cycle doesn't match the Koha development cycle. It
is near impossible for the Documentation team to document all the new
features before the new Koha version is released. The manual published
alongside the new Koha version is always behind.
- When the manual is updated, the update is made to the master branch
- the one that matches the numbering of the Koha version currently in
development. This master branch isn't visible (unless you know where
to find it). It is possible to "backport" updates to older versions of
the manual but this is not straightforward. Because we are behind with
documenting features, some updates would have to go back through
several older versions of the manual, making the process even less
straightforward. I'll be honest: it's rare these days when we backport
to older versions.
- For library teams, that means the explanation of a feature in their
Koha version is more likely to be in a newer version of the manual
(than in the one they'll land on when clicking the Help button).

One manual - why it would be beneficial
- Everything in one place: all the latest additions and improvements
to the manual available straight away to everyone everywhere.
- Translated manuals: only one version to keep on top of.
- Easier to manage by the community.

How it could work; questions and concerns identified
- What if something changes in a newer version of Koha / only exists
in some versions but not others? Wouldn't that be confusing in one
manual?
We would need to clearly mark sections with the Koha versions it
applies to, e.g. "until 22.11", "from 23.05".


Aude Charillon
Customer Services Consultant
PTFS Europe
aude.charil...@ptfs-europe.com
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

Re: [Koha] [EXTERNAL] Re: Suggestion for a Debian Managed VPS

[King, Fred]

If you're willing to give up a few of the features you want, you might want to 
consider Digital Ocean. They don't do automatic updates and if you want UFW or 
Time2Ban you have to install and configure those yourself. They do offer 
automatic backups for an extra 10%. I'm running our small library with 4GB RAM 
and something like 80GB SSD for around $30USD per month. They have other 
options with more RAM, CPUs and SSD sizes. You can also make a snapshot of your 
Koha instance so if you do something horrible to it you can restore from the 
snapshot. They're also a Koha mirror so the updates that you have to do 
yourself are pretty speedy.

No, I don't get a referral fee. 😊

Fred King, MSLS, AHIP
Medical Librarian, MedStar Washington Hospital Center
fred.k...@medstar.net
202-877-6670
ORCID -0001-5266-0279
MedStar Authors Catalog: http://medstarauthors.org

People who can't distinguish between etymology and entomology bug me in ways I 
cannot put into words.
--Anon

-Original Message-
From: Koha  On Behalf Of Alessandro Tedesco
Sent: Thursday, September 7, 2023 6:52 AM
To: koha@lists.katipo.co.nz
Subject: [EXTERNAL] Re: [Koha] Suggestion for a Debian Managed VPS



**ATTENTION: This email originated from outside the MedStar Health network.
 ** DO NOT CLICK links or attachments unless you recognize the sender and know 
the content is safe.

 

Hello David,

thank you for your reply! I will take a look at the Hostin Provider that you 
have suggested. Alessandro

Il giorno gio 7 set 2023 alle ore 12:07 David Liddle  ha
scritto:

> Hello Alessandro, it might be helpful to list the VPS providers that 
> you have rejected because of your criteria. It will make it easier for 
> people on the list to know whether or not to suggest the providers 
> they have in mind.
>
> Have you already looked at EuroVPS 
> (https://urldefense.com/v3/__https://www.eurovps.com/debian-vps)?__;!!
> D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp
> 68vLIUFUym6YvXZWy3U7D1BRwiVPBoL0KB8mfTMvDcg$
>
> Regards,
>
> David Liddle
> System Administrator
> david.lid...@wycliff.de (but not for this list)
>
> Wycliff e.V., 
> https://urldefense.com/v3/__https://wycliff.de__;!!D7IIWT94AA!9oRdOaf2
> lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U
> 7D1BRwiVPBoL0KB8kkufSmLA$ Seminar für Sprache und Kultur, 
> https://urldefense.com/v3/__https://spracheundkultur.org__;!!D7IIWT94A
> A!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUy
> m6YvXZWy3U7D1BRwiVPBoL0KB8n7ey5jaQ$
> Internationales Tagungszentrum Karimu, 
> https://urldefense.com/v3/__https://karimu.de__;!!D7IIWT94AA!9oRdOaf2l
> Fh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U7
> D1BRwiVPBoL0KB8mDcB1Ovg$
>
>
> On Thu, Sep 7, 2023 at 11:25 AM Alessandro Tedesco 
>  wrote:
> >
> > Hello everyone,
> >
> >
> > I'm going to quit my old koha installation running on a Centos VPS 
> > and I would like to switch to a new Debian VPS (so I can install and 
> > manage
> Koha
> > more easily).
> >
> >
> > However, I'm having a lot of difficulty choosing a hosting provider: 
> > in fact, my old Centos VPS was Fully Managed (i mean that the 
> > Hosting
> Provider
> > take care of the general security, the update and the backup of the 
> > VPS, and that they have a ticketing system for all the technical 
> > issues), but
> at
> > the moment I haven't found hosting provider that offer a Fully 
> > Managed
> VPS
> > with Debian.
> >
> >
> > Does anyone have any suggestions related to this topic? Thanks!
> Alessandro
> > ___
> >
> > Koha mailing list  
> > https://urldefense.com/v3/__http://koha-community.org__;!!D7IIWT94AA
> > !9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFU
> > ym6YvXZWy3U7D1BRwiVPBoL0KB8k0cVoGUQ$
> > Koha@lists.katipo.co.nz
> > Unsubscribe: 
> > https://urldefense.com/v3/__https://lists.katipo.co.nz/mailman/listi
> > nfo/koha__;!!D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX
> > 4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U7D1BRwiVPBoL0KB8nHtcufgQ$
> ___
>
> Koha mailing list  
> https://urldefense.com/v3/__http://koha-community.org__;!!D7IIWT94AA!9
> oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6Y
> vXZWy3U7D1BRwiVPBoL0KB8k0cVoGUQ$
> Koha@lists.katipo.co.nz
> Unsubscribe: 
> https://urldefense.com/v3/__https://lists.katipo.co.nz/mailman/listinf
> o/koha__;!!D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbi
> c9NHqOJuhFp68vLIUFUym6YvXZWy3U7D1BRwiVPBoL0KB8nHtcufgQ$
>
___

Koha mailing list  
https://urldefense.com/v3/__http://koha-community.org__;!!D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U7D1BRwiVPBoL0KB8k0cVoGUQ$
Koha@lists.katipo.co.nz
Unsubscribe: 
https://urldefense.com/v3/__https://lists.katipo.co.nz/mailman/listinfo/koha__;!!D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1

Re: [Koha] [EXTERNAL] Re: Suggestion for a Debian Managed VPS

[Alessandro Tedesco]

Hi Fred,
thank you very much for this indication and also for sharing your precious
experience with this Hosting Provider.
I will try to look at their VPS plans.
Alessandro


Il giorno gio 7 set 2023 alle ore 16:48 King, Fred 
ha scritto:

> If you're willing to give up a few of the features you want, you might
> want to consider Digital Ocean. They don't do automatic updates and if you
> want UFW or Time2Ban you have to install and configure those yourself. They
> do offer automatic backups for an extra 10%. I'm running our small library
> with 4GB RAM and something like 80GB SSD for around $30USD per month. They
> have other options with more RAM, CPUs and SSD sizes. You can also make a
> snapshot of your Koha instance so if you do something horrible to it you
> can restore from the snapshot. They're also a Koha mirror so the updates
> that you have to do yourself are pretty speedy.
>
> No, I don't get a referral fee. 😊
>
> Fred King, MSLS, AHIP
> Medical Librarian, MedStar Washington Hospital Center
> fred.k...@medstar.net
> 202-877-6670
> ORCID -0001-5266-0279
> MedStar Authors Catalog: http://medstarauthors.org
>
> People who can't distinguish between etymology and entomology bug me in
> ways I cannot put into words.
> --Anon
>
> -Original Message-
> From: Koha  On Behalf Of Alessandro
> Tedesco
> Sent: Thursday, September 7, 2023 6:52 AM
> To: koha@lists.katipo.co.nz
> Subject: [EXTERNAL] Re: [Koha] Suggestion for a Debian Managed VPS
>
>
>
> **ATTENTION: This email originated from outside the MedStar Health network.
>  ** DO NOT CLICK links or attachments unless you recognize the sender and
> know the content is safe.
>
>
>
> Hello David,
>
> thank you for your reply! I will take a look at the Hostin Provider that
> you have suggested. Alessandro
>
> Il giorno gio 7 set 2023 alle ore 12:07 David Liddle 
> ha
> scritto:
>
> > Hello Alessandro, it might be helpful to list the VPS providers that
> > you have rejected because of your criteria. It will make it easier for
> > people on the list to know whether or not to suggest the providers
> > they have in mind.
> >
> > Have you already looked at EuroVPS
> > (https://urldefense.com/v3/__https://www.eurovps.com/debian-vps)?__;!!
> > D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp
> > 68vLIUFUym6YvXZWy3U7D1BRwiVPBoL0KB8mfTMvDcg$
> >
> > Regards,
> >
> > David Liddle
> > System Administrator
> > david.lid...@wycliff.de (but not for this list)
> >
> > Wycliff e.V.,
> > https://urldefense.com/v3/__https://wycliff.de__;!!D7IIWT94AA!9oRdOaf2
> > lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U
> > 7D1BRwiVPBoL0KB8kkufSmLA$ Seminar für Sprache und Kultur,
> > https://urldefense.com/v3/__https://spracheundkultur.org__;!!D7IIWT94A
> > A!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUy
> > m6YvXZWy3U7D1BRwiVPBoL0KB8n7ey5jaQ$
> > Internationales Tagungszentrum Karimu,
> > https://urldefense.com/v3/__https://karimu.de__;!!D7IIWT94AA!9oRdOaf2l
> > Fh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U7
> > D1BRwiVPBoL0KB8mDcB1Ovg$
> >
> >
> > On Thu, Sep 7, 2023 at 11:25 AM Alessandro Tedesco
> >  wrote:
> > >
> > > Hello everyone,
> > >
> > >
> > > I'm going to quit my old koha installation running on a Centos VPS
> > > and I would like to switch to a new Debian VPS (so I can install and
> > > manage
> > Koha
> > > more easily).
> > >
> > >
> > > However, I'm having a lot of difficulty choosing a hosting provider:
> > > in fact, my old Centos VPS was Fully Managed (i mean that the
> > > Hosting
> > Provider
> > > take care of the general security, the update and the backup of the
> > > VPS, and that they have a ticketing system for all the technical
> > > issues), but
> > at
> > > the moment I haven't found hosting provider that offer a Fully
> > > Managed
> > VPS
> > > with Debian.
> > >
> > >
> > > Does anyone have any suggestions related to this topic? Thanks!
> > Alessandro
> > > ___
> > >
> > > Koha mailing list
> > > https://urldefense.com/v3/__http://koha-community.org__;!!D7IIWT94AA
> > > !9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFU
> > > ym6YvXZWy3U7D1BRwiVPBoL0KB8k0cVoGUQ$
> > > Koha@lists.katipo.co.nz
> > > Unsubscribe:
> > > https://urldefense.com/v3/__https://lists.katipo.co.nz/mailman/listi
> > > nfo/koha__;!!D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX
> > > 4gbic9NHqOJuhFp68vLIUFUym6YvXZWy3U7D1BRwiVPBoL0KB8nHtcufgQ$
> > ___
> >
> > Koha mailing list
> > https://urldefense.com/v3/__http://koha-community.org__;!!D7IIWT94AA!9
> > oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbic9NHqOJuhFp68vLIUFUym6Y
> > vXZWy3U7D1BRwiVPBoL0KB8k0cVoGUQ$
> > Koha@lists.katipo.co.nz
> > Unsubscribe:
> > https://urldefense.com/v3/__https://lists.katipo.co.nz/mailman/listinf
> > o/koha__;!!D7IIWT94AA!9oRdOaf2lFh73dmpR67YvB9SNv2M1jEQ0lcheYFTMAGX4gbi
> > c9NHqOJuhFp

[Koha] koha-US Board Meeting Minutes - Wednesday, September 6, 2023

[Jennifer Marlatt]

 Hello,

Here's a link to the minutes from the koha-US board meeting on Wednesday,
September 6, 2023 -
https://docs.google.com/document/d/10ix1jSJV8Em0SnX6lEcSRBdq_NpiWjCOrHrbA-7snVc/edit?usp=sharing

koha-US meetings are open to all! Board meetings are held on the first
Wednesday of each month at 8:30 PT / 9:30 MT / 10:30 CT / 11:30 ET.

The next koha-US general meeting will be held during the 2023 koha-US
Annual Conference on Friday, September 22, 2023 at 7:45 PT / 8:45 MT / 9:45
CT / 10:45 ET  (time converter

).

The agenda for the next general meeting is available here -
https://docs.google.com/document/d/1HmuKvEdnVErjNEa0PFIswzWVKyFTyfMfYNWsBONVxso/edit?usp=sharing

If you have additional topics for the agenda, please send them to
secret...@koha-us.org.

Jennifer Marlatt
koha-US Secretary
secret...@koha-us.org
___

Koha mailing list  http://koha-community.org
Koha@lists.katipo.co.nz
Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha

[Koha] Documentation - Are automated screenshots the way to go?

[Caroline Cyr La Rose]

Hello dear community,

TLDR; We have a potential way of automating the screenshots of the 
manual that has interesting benefits. However, we are not sure if it 
would work with our screenshots. I would like to ask for your help 
analyzing the screenshots, to know if they are easy or difficult to 
automate. See 
https://docs.google.com/document/d/1wscmVmficQSpCmUDPNEYLp-TFJoR3gay2O6zS8q-Kak/edit?usp=sharing 
for how to analyze a screenshot. Read on for more information and a 
kitty at the bottom!


In the documentation team, we're looking at the possibility of 
automating the screenshot taking for the manual. If you've visited the 
manual before, you surely have stumbled upon screenshots of the 
interface that don't look anything like your interface. Our manual 
contains more than 1600 screenshots, with more being added with every 
new feature. This means that if there is a change in the interface, we 
must retake the screenshot. After the redesign of 22.11, all our 
screenshots were suddenly out of date. We are updating them little by 
little, but it is time consuming for the very small team of documenters 
that we are, so it is unimaginable to think that we can update all of 
them every version. We would rather spend our time documenting exciting 
new features than retaking screenshots simply because the interface 
looks different. And if you're thinking, "Well, we can live with 
screenshots from version 22.05 or even 20.11, it's not that bad!" take a 
look at this screenshot that is currently still in the latest manual as 
I write this 
https://koha-community.org/manual/latest/en/html/_images/fastadd.png (in 
the fast add cataloguing section 
https://koha-community.org/manual/latest/en/html/circulation.html#fast-add-cataloging 
; this section hasn't had any new features for a while so we never went 
over it to update it). Do you recognize it? :D


At Kohacon23, Jonathan Druart proposed a way to automate the screenshot 
taking using Cypress and Cypress Studio. Cypress is a tool mainly used 
by web developers for what is called end-to-end testing, where they 
write up a bunch of commands, input that into a browser and the browser 
will execute the commands as if it was a normal user. Cypress Studio is 
an extension of Cypress to be able to use Cypress without knowing how to 
write up the bunch of commands, i.e. for people like me who don't code. 
When using Cypress Studio, it records all the clicks and key presses 
that you do and converts it into code (that needs to be cleaned 
according to Jonathan). You can then feed that code into the browser and 
the browser will click where you clicked and type what you typed. (It 
does it super fast too, it's really cool to watch it go!)


For our purposes, anyone in the documentation team (or any motivated 
community member willing to help! *wink wink*) would take the screenshot 
using Cypress Studio. Then a developer would go in and clean the code 
generated by Cypress Studio. Then, every time we create a new manual (or 
whenever we want), we would run the Cypress scripts and all the 
screenshots would be automagically updated!


As well as having nice, up-to-date screenshots in our manual, this 
method has other advantages:
- It would allow us to have translated screenshots in the translated 
manuals.
- It would allow us to take the screenshot once and have it updated for 
every version with minimal additional work (admittedly it takes a lot 
more time to take the automated screenshot, but hopefully, this time 
would be saved in the future by not having to manually take the 
screenshot again).
- It would allow us to catch regressions in Koha (if something that 
should be there suddenly isn't there anymore, for example).


As the automation would be as time-consuming, if not more, than the 
manual way in the short-term, and would implicate developers as well as 
the documentation team, we would like to analyze the difficulty of 
automating before jumping in. Some screenshots are super easy to get to: 
you go into Cataloguing, click 'New record' and bam!, you're ready to 
take this screenshot 
https://koha-community.org/manual/latest/en/html/_images/catalogingform.png 
. Some screenshots need more preparation, like you need to turn on a 
system preference, then add a fine to a patron account, then try to 
check out an item to that patron and *now* you can take this screenshot 
https://koha-community.org/manual/latest/en/html/_images/patrondebt.png 
. If the majority of existing screenshots are hard or impossible to 
automate, it is not worth the trouble. However, if the majority of 
existing screenshots are easy, automation could be a way to save time in 
the long run. The thing is that we don't know how many are easy and how 
many are difficult.


This is where I would like to ask for your help. We would like to 
analyze the difficulty of about 10% of the images (around 100 to 150) in 
order to determine if the automation would be worth investing into. We 
curren