Bug 557

Summary:	Yocto website should include a glossary
Product:	[Infrastructure] Website	Reporter:	Dave Stewart <david.c.stewart>
Component:	web-content	Assignee:	Jeff Osier-Mixon <jefro>
Status:	RESOLVED FIXED	QA Contact:
Severity:	enhancement
Priority:	Medium	CC:	alexandru.c.georgescu, Infras.watcher, infras.web.watcher, jefro, ke.yu, sgw
Version:	unspecified
Target Milestone:	Q4
Hardware:	x86
OS:	Multiple
Whiteboard:	26-aug-2011: enhancement
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	---

Description Dave Stewart 2010-12-01 11:47:44 UTC

Comments from Jon Masters today - we should have a specific glossary of terms on yoctoproject.org. Some examples I have included may actually change as we get more input on them. Examples of the things it should include:

Yocto Project
Poky Build System
Yocto Kernel
Yocto Metadata Layers
Swabber
Pseudo
Cross Prelink
Build profiles
Custom Yocto Images
SDK (which as of today we're calling "App Dev Tools for the device"
Example images

Comment 1 Scott Rifenbark 2011-04-29 13:48:41 UTC

Where on the website would we have a glossary?  My suggestion would be under the 'Documentation' tab.

Comment 2 Scott Rifenbark 2011-08-26 15:51:15 UTC

I am not sure I agree with having a glossary on the website.  The YP dev manual has YP terms defined in it.  We could point the web person to the documentation.  But, if we really want one then we can create one later.  I have marked this bug as an enhancement for now.

Comment 3 Alexandru Georgescu 2012-08-16 11:52:33 UTC

(In reply to comment #2)
> I am not sure I agree with having a glossary on the website.  The YP dev
> manual has YP terms defined in it.  We could point the web person to the
> documentation.  But, if we really want one then we can create one later.  I
> have marked this bug as an enhancement for now.

Hi,
Is there any update regarding the glossary?

Thanks,
Alex.

Comment 4 Scott Rifenbark 2012-09-04 21:16:30 UTC

Jeff, 

The last mail I saw on this issue was a reply by you stating that the new website would plan to focus on defining some terms.  Is that still true?  Also, we do have a Terms section in the YP Development Manual that could be leveraged and/or updated to be in line with what comes out of the new website.  

Right now this bug has me as the "Assigned To" person.  We might consider changing it to you since you are the force behind the new website.  I can work with you to be sure all terms are sync'ed between the website and the documentation. 

Scott

Comment 5 Jeff Osier-Mixon 2012-09-04 21:20:04 UTC

Hi Scott - yes, I do have plans for this, although the website is moving more slowly than anticipated. Let's plan to look over the existing glossary (in the docs, yes?) this week and decide whether it is sufficient.

thanks

Comment 6 Scott Rifenbark 2012-09-04 21:22:38 UTC

Sounds good.  Here is the link to the latest section for Terms:

http://www.yoctoproject.org/docs/1.3/dev-manual/dev-manual.html#yocto-project-terms

I can add/change/delete as we go.

Scott

Comment 7 Jeff Osier-Mixon 2013-01-28 18:34:45 UTC

Putting this back on my radar

Comment 8 Jeff Osier-Mixon 2013-02-04 23:46:28 UTC

Scott & Dave - We have a terms glossary in the docs. Does anything else need to be done with this?

Comment 9 Jeff Osier-Mixon 2013-03-20 19:56:58 UTC

This is now available on the website (and has been for a while). Closing.

http://www.yoctoproject.org/docs/current/mega-manual/mega-manual.html#ref-variables-glossary