[rt-users] Upgraded 4.0.0 with RTFM 2.0 to RT 4.2 - can RTFM be removed?

[Giuseppe Sollazzo]

Hi Todd,
thanks for the reply:

>> Can I recommend a link to this is added to the distribution's
>> README/UPGRADE files?

> Hi, thanks for the suggestion. Can you be more specific as to where
> you'd like to see the link? Perhaps a diff?

Ah, no I mean: as Articles are a built-in functionality, but this doesn't work "out of the box" - as in: unless custom fields are properly configured - it would be good to have in the README a section for Articles, simply stating "to configure the Articles functionality please follow the instructions at http://bestpractical.com/rt/docs/latest/customizing/articles_introduction.html".
As Articles require a somewhat different list of configuration tasks than other features, I think having this in the README would prevent headaches. Looking at the forums, it seems not to be a rare occurrence.

>I didn't reply to your initial question because I was a bit confused as
>to how you got in to the situation you did. You said you were upgrading
>from 4.0 with RTFM, but starting with 4.0, articles were built in - you
>wouldn't install RTFM on a 4.0 system:

Yes, I'm sorry about that indeed! I got really confused about what the lack of an "editable content field" meant. Looking on the forums, it was suggested that this depended by a number of missed configurations in RTFM and I suspected our move from 3.8 to 4 had "carried over" databases. I know it doesn't make any sense - I've now found our RT system history and realised what was going on.


> docs/UPGRADING-4.0 has the details for upgrading from RTFM to articles,
> but that wouldn't have normally applied to you because RTFM isn't
> compatible with 4.0+

Correct - and this is actually quite good. 
Going back to my first point, though, this makes it evident that the distribution contains info about how to move from RTFM to Articles, but no pointers on how to setup Articles in the first place. If this could be amended, it would be great, and as I say just a link in the README would suffice.

Thanks,
Giuseppe

--
Giuseppe Sollazzo
Senior System Analyst

Member of the Open Data User Group (Cabinet Office)
Member of the Technical Standards Board (Cabinet Office)​
Member of the Health and Social Care Transparency Panel (Department of Health)


Computing Services
Information Services
St George's, University of London
Cranmer Terrace
London SW17 0RE

gsollazz at sgul.ac.uk
+44 20 8725 5160
@sgulit

St George’s, University of London is proud to be a Stonewall Diversity Champion: ‘people perform better when they can be themselves’.


________________________________________
From: rt-users <rt-users-bounces at lists.bestpractical.com> on behalf of Todd Wade <todd at bestpractical.com>
Sent: 21 May 2015 14:30
To: rt-users at lists.bestpractical.com
Subject: Re: [rt-users] Upgraded 4.0.0 with RTFM 2.0 to RT 4.2 - can RTFM be    removed?

On 5/19/15 11:07 AM, Giuseppe Sollazzo wrote:
> Ok, I got it working. The "Content" is actually a custom field that
> needs to be configured.
>
> It's reported at
> https://bestpractical.com/docs/rt/latest/customizing/articles_introduction.html
>
>
> Can I recommend a link to this is added to the distribution's
> README/UPGRADE files?

Hi, thanks for the suggestion. Can you be more specific as to where
you'd like to see the link? Perhaps a diff?

I didn't reply to your initial question because I was a bit confused as
to how you got in to the situation you did. You said you were upgrading
from 4.0 with RTFM, but starting with 4.0, articles were built in - you
wouldn't install RTFM on a 4.0 system:

https://www.bestpractical.com/rtfm/
> RTFM has now reached end-of-life. However, as of RT 4.0.0, RTFM's
> functionality was integrated into RT itself as Articles.

docs/UPGRADING-4.0 has the details for upgrading from RTFM to articles,
but that wouldn't have normally applied to you because RTFM isn't
compatible with 4.0+