Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
talk:start [2012/09/13 21:04 (UTC)]
mariostg
talk:start [2020/05/26 10:35 (UTC)]
nacena
Line 1: Line 1:
- +am Staff Author at https://www.fieldengineer.com a Marketplace ​for On Demand telecom workforceranging from telecom field engineers ​to high-level network engineersproject managers ​and Network Architects ​in 146 countries. [[cisco ise]]https://www.fieldengineer.com/blogs/cisco-ise-deployment-guide  
-**Main Page Talk** + 
- +
-think it would be good idea to add a link to the beginners_guide following this link: +
-  * [[slackware:​slackpkg|Update your new system]]: Configure and use slackpkg. +
-Like so: +
-  * [[slackware:​beginners_guide|Beginners guide]]: Some post installtion consideration +
- ​--- ​//[[wiki:​user:​mariostg|Mario St-Gelais]] 2012/09/13 13:58// --- //​[[wiki:​user:​mariostg|Mario St-Gelais]] 2012/09/13 13:58// +
- +
-082012@1618hrsEDT - I was wondering if there was a way to use the standard Slackware logo and wallpaper from the Slackware website for this wikiIt would give it that comfortable old shoe type feeling, I think. ~V. T. Eric Layton +
- +
------- +
->I think that depends on whether it is decided to place the wiki under a slackware.com subdomain or slackdocs.org is going to be favoured. If it is not slackware.com site I would not want to use a full set of Slackware visuals. \\ --- //​[[wiki:​user:​alienbob|Eric Hameleers]],​ Mon Aug 20 22:11:13 UTC 2012// +
- +
------- +
->>​082012@1821hrsEDT - Ah! That makes since, Eric. Thanks ​for the reply. I guess it's something we can consider down the road a piece. ~VTEL +
- +
------- +
-The front page says that you must create an account to be able to edit the wiki... OKbut where is the link to create such an account? I love Slackware and I'd love to participate! (and I have my own Slackware wiki as well: http://​www.gilandre.net/​cgi-bin/​wiki.cgi/​SlackwareLinuxPage )... +
- +
------- +
->Simple. Click "​logon"​ and then register. \\  --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/08/23 07:05// +
- +
------- +
- +
-082312@2100hrsEDT - I've created a hyperlink on the main page in the paragraph under the Help topic where it says "you must create an account"​. Hopefullythis will make it easier for folks to figure out how to register new accounts. ~vtel +
- +
------- +
-Is it really useful to hyperlink every mention of "​Slackware Linux" to slackware:​slackware ​and even  +
- "​documentation"​ to the main page itself? Why "​NEWS"​ is in uppercase?​ +
-http://docs.slackware.com/​start?​do=diff&​rev2%5B0%5D=1345722255&​rev2%5B1%5D=&​difftype=sidebyside +
-\\ --- //[[wiki:​user:​bormant]]// +
- +
- +
----- +
- +
- +
-Yes, NEWS looks out of step with the rest of the page. I've changed it.  --- //​[[nowbrians@yahoo.co.uk|Brian Lawrence]] 2012/08/24 13:49// +
------- +
- +
-== NOTICE TO ALL == +
- +
-**PLEASE** do not edit the Main Page without consulting someone on the admin/​editor team first !!! \\  --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/08/24 15:15// +
------- +
- +
-I think a link in the "​Help"​ section is wrongThe hyperlink tells to '​create an account',​ but the link is '​start?​do=login',​ so to login. In the french translation,​ I supposed the text was right and the link wasn'​t. Also, I dont think that links must have the '​http://​docs.slackware.com/' part. In fact, the register link can simply be "?​do=register"​. EDIT: the french translation shows "?​do=register"​ (so pages are similar)  +
---- //​[[wiki:​user:​zithro|zithro]]//​ +
- +
------- +
- +
->You are absolutely correct zithro. I will alert Eric or Niki to change the link to: http://​docs.slackware.com/​start?​do=register +
-Thanks for alerting us to this. +
- +
- --- //​[[nocturnal.slacker@hotmail.com|V. T. Eric Layton]] 2012/08/25 11:19// +
- +
------- +
- +
-Do the site admins intend to follow the documentation structure recommended on [[http://​docs.slackware.com/​slackdocs:​contributing#​subjects_to_cover]] and if so will it be added to the main page immediately or will it be added as the content is created? \\  ---//​[[wiki:​user:​mfillpot|mfillpot]] 2012/08/26 02:03 EDT// +
- +
------- +
->​Matthew,​ the TOC is just a list of suggestions,​ AFAIK. I do not think there'​s any specific plan to follow it literally. Having said that, it's for Eric and Nicolas to decide. +
---- //​[[wiki:​user:​sycamorex|sycamorex]] 2012/08/27 17:04 GMT// +
- +
----- +
->>@ Matthew & Marcin - We are still in flux over the TOC issue, I believe. I am of the belief that the main page needs a traditional table of contents (or a link to one in the toolbox). Currently, I'm using the [[http://​docs.slackware.com/?​do=index|Site index]] link to navigate, but that leaves a lot to be desired. I'm not really sure what Eric and Niki's vision for a TOC is, to be honest. Niki will be back with us later this week. He and Eric can comment further here or on that list to give us a better direction on which to focus. --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/28 18:45// +
- +
----- +
- +
-Shouldn'​t the header on each page of the wiki say, "​Welcome to the Slackware __Linux__ Documentation Project"? ​  +
- +
- --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/28 19:14// +
- +
----- +
- +
- +
- +
-Also, while I'm thinking about it... The "​Navigation"​ sidebar shows all external links, with the exception of the loop link to the main page. Shouldn'​t "​Navigation"​ contain links to areas of the wiki like the TOC, Random Article generator, Help pages, etc? And the external links (including one for Slackware.com) could be placed in a sidebar labeled "​Links"​ or something similar.  +
-   +
-  * Navigation +
-       +
-      * Main Page (loop link) +
-      * Project Charter +
-      * Staff +
-      * Site News +
-      * Table of Contents +
-      * Random Article +
-      * Help +
-   +
-  * Search Box +
-   +
-  * Toolbox +
-       +
-      * What Links Here +
-      * Recent Changes +
-      * Media Manager +
-      * Site Index (Map) +
-      * Printable Version +
-      * Permanent Link +
-      * Cite This Article +
-   +
-  * Slackdocs +
-       +
-      * Docuwiki Manual +
-      * Docuwiki Syntax +
-      * Slackdocs Style Guide +
-   +
-  * Slackware Links +
-       +
-      * Slackware.com +
-      * Slackware-Current Change Log +
-      * Package Browser +
-      * Slackware Mirrors +
-      * LinuxQuestions.org/​Slackware +
-   +
-  * Language +
-   +
-  * QR Code +
- +
- +
- +
-   +
- +
-Thoughts? ​ --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/28 18:59// +
- +
----- +
-Time's up for me tonight but I think you are making valid points about the sidebar Eric. I will work on that tomorrow.\\ ​ --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/08/29 15:38// +
- +
----- +
- +
->Good night, Eric. Pleasant "​alien"​ dreams to you. ;)  --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/29 16:12// +
- +
------- +
-I changed the sidebar content to align mostly with what you suggested. I think there is a better logical separation of topics now. \\ What I found out in the process is that the two pages [[slackdocs:​styleguide|Style ​guide for articles published at SlackDocs]] and [[slackdocs:​editing_rules|Editing Etiquette]] should really be merged into one. \\  --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/08/30 12:56// +
- +
->Looks really good, Eric. My only suggestion (complaint ;-) ) would be that we need to use consistent capitalization rules for the sidebar headings and the links within the sidebars (see my suggestion above). I prefer this because I'm a hard-ass when it comes to the written word. I think texting and chatrooms have done major damage to proper writing and punctuation over the last decade. I mean how hard is it to let your left pinky hit that Shift key? :-) It makes for a more professional presentation;​ something of which we'll all be proud. ​ --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/30 13:27// +
- +
->Oh, and if someone hasn't already merged the styleguide and editing_rules,​ I'll see what I can do to facilitate. ​ --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/30 13:37// +
- +
------- +
-Looking at the start page and thinking about some people'​s desire to see the FAQ and beginner'​s guide standing out on that page - what if the current block of "​Getting Started"​ is split, with just absolute beginner info remaining in "​Getting Started"​ and then adding a new section below that with another heading. Suggestions?​ "Dive into Slackware"?​ \\  --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/08/30 12:59// +
- +
->​Personally,​ I would prefer a more technical/​professional name for it... "For Advanced Users" or "Your Next Steps In Slackware",​ etc.  --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/30 13:27// +
- +
------- +
- +
-All good! Things are really shaping up. The Main Page is the hook. It needs to be enticing, informative,​ concise, etc. You always want that cover page to get their attention. :-) Great work, everyone! ​ --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/08/30 13:34// +
- +
- +
------- +
- +
-Has there been a syntax decided on to note which version of Slackware (or application) a page is applicable to?  Subtle changes that aren't caught/​updated will cause all sorts of grief. EXAMPLE: +
-<​code>​Slackware 12.1 (and later): mysql_install_db --user=mysql</​code>​ +
-<​code>​ Slackware 12.0 (and before): mysql_install_db</​code>​ +
- +
-Also, my 2 cents: "​...depends on whether it is decided to place the wiki under a slackware.com subdomain or slackdocs.org is going to be favoured"​ - docs.slackware.com looks more professional (which I realise in the Slackware realm, isn't much of a concern but...). - arfon +
------- +
-Please follow our guidelines about [[slackdocs:​tutorial#​use_of_discussion_pages|updating the discussion pages]]... in particular the use of a Wiki signature function - it __adds a timestamp__.\\ +
-I noticed a [[:​start?​rev=1346889810&​do=diff|page edit of our Wiki start page]] by a non-staff member. It made me realize that we must protect our start page from vandalism (even though this particular edit does not belong in that category) and therefore made the [[:​start|start page]] read-only to everybody except the staff editors.\\ If you (editors) would be so kind to evaluate if mentioning slackpkg on the main page is beneficial? //I think not!// \\  --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/09/11 16:41// +
- +
->Re: slackpkg on main page -- myeh... it's not necessary, but it is something a beginner would need to use after installing their system. \\ --- //​[[wiki:​user:​nocturnal.slacker|V. T. Eric Layton]] 2012/09/11 17:33// +
- +
->Re: slackpkg on main page: Noting slackpkg on the main page is not necessary since it should be documented in the install article and will be covered in all package management tutorials. \\   --- //​[[wiki:​user:​mfillpot|Matthew Fillpot]] 2012/09/11 20:48// +
- +
-Been thinking this over. What we might want to have instead is a chapter "​slackware maintenance"​ which would not only include instructions about how to configure and use slackpkg, but also some information about best practices: following the ChangeLog.txt ; subscribing to the security mailing list ; setting up a cronjob that automatically downloads (but not installs) new patches and sends you an email upon new arrivals ; stuff that any aspiring Slackware sysadmin (and home user) should know of. A link to such a chapter would be good to have on the main page \\  --- //​[[wiki:​user:​alienbob|Eric Hameleers]] 2012/09/12 05:05//  +
- +
-------+

In Other Languages
QR Code
QR Code talk:start (generated for current page)