The general population's use of the expression, "web page" is quite broad. It refers to what you see in your browser when your current tab or window is pointed to a specific URL. That "web page" is only slightly related to one of the two content-types that Drupal ships with a fresh core install called "Page."

In conversations with clients and in the documentation I've been doing for clients recently I had noticed that I've spent a bunch of energy disambiguating these two different meanings of the word "page". And then I realized, "Why don't I just dump Drupal's 'page' as a content-type for another label?"

I believe this problem is confusing clients a LOT more than I thought it was. I've been very aware of the need to explain to clients that content exists independent from the concept of what web page it can be viewed on. And I'll then explain, in simple language, how a "web page" is made up of queries -- instructions -- which tell the web page what to display. I think I've underestimated, however, how much Drupal's "Page" content-type is making that conversation harder.

There is already a commit in D7 which changes "story" to "article." In that thread (http://drupal.org/node/197765), Catch reported that at the UMN usability studies, the "Page" content-type was very confusing to people (http://drupal.org/node/197765#comment-762730). So I guess this post is a follow-up to Catch's comment there.

I would suggest "Info" as an alternative. Any other ideas? Or how about "Something Else" (e.g. node/add/something-else)? Only half kidding on that.

Do people agree that "Page" is a problem?

Shai
Owner, Content2zero Web Development

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

Z2222’s picture

Maybe rename it to "Basic Page" so that people understand it's not the only type of page, but is just the basic way to create a new page on the site?

Shai’s picture

I'd love to keep the word "Page" out completely. If I create a view which pulls nodes of type "basic page" and there are ten of them, then I have a "web page" (the path for the view I just created) that includes ten "basic pages" within it. I think that is confusing.

Developers don't think so much in terms of "web pages" but people do. And so I think putting some language distance between these two concepts will make Drupal friendlier out-of-the-box.

Shai

uNeedStuff’s picture

Maybe it's how your using it that is confusing. I'm no Drupler but I always explain it as something that doesn't change and has a static address.

Where I've found the confusion comes in is saying it's similar to a story. This is how I explain it in WordPress as well. Yes it doesn't have to fit my definition, however I've found that creating additional content types so that a Page is only used as a Page (doesn't change often and has a static address) seems to be understandable. This helped me to understand as well.

Shai’s picture

@WebWeaver64, there is nothing about the "Page" content-type that is any different from any other content-type re: having a "static address" or not. Every Drupal node gets assigned a node id, and thus has a url dedicated toward it, no matter what content-type it is.

The word "page," coming from the world of bound books, is a metaphor for how content is displayed. But in Drupal it is being used as a descriptor of a content-type. It some how suggests the word page itself describes a particular nature of content. The connection to "static" is a reach... a page in a bound book you can't change I guess. But a Drupal page you certainly can. Very confusing.

Since Drupal has essentially no sample content that ships with it, the "article" and "page" content-types being one of the few pieces of pre-configured site architecture, I think it's worth answering the question, "Why are they there?"

Now that fields will be in core, maybe it would serve everyone better if a second content-type actually had different fields. That would be an example for newbies about the power of content-types.

Drupal is a blank slate on which you can do anything... but it comes idiosyncratically pre-configured with articles that prints dates and bylines and that are promoted to the front page and pages which are not promoted to the front page. How long does it take new folks to realize those are just settings in publishing options and have nothing to do with content-type?

I just think that getting rid of the name "Page" for a second sample content-type will at least go some way in preventing confusion.

Shai

kaakuu’s picture

The following is very clearly written when you go to add new content ( Drupal 7 dev version)

# Article
Use articles for time-specific content like news, press releases or blog posts.

# Page
Use pages for your static content, such as an 'About us' page.

The accompanying texts clarify the use, and if they not the text can be easily changed for your clients according as you feel appropriate. Probably the introduction of 'Article' and the descriptive texts came after much debates and discussions.

That said, very personally I believe Story was quite OK, irrespective of what the user tests may have said, and Page may have been better called Article. Story better in the sense, that what hits front page or headline are called Stories, top stories are common terms in real world.

When you enable blog which is not enabled by default, these texts become

* Article
Use articles for time-specific content like news, press releases or blog posts.
* Blog entry
Use for multi-user blogs. Every user gets a personal blog.
* Page
Use pages for your static content, such as an 'About us' page.

Now this gets somewhat confusing as Article is stated to be for 'blog posts' and again Blog entry is for blog. What was probably meant was blog posts in Article is for single user blog posts.

In final thought what I feel is little longish names are the best - they will probably be never accepted because they are two words long (wait! Blog entry is also two word, hmm, but perhaps not that longish?) - these longish names are longish but they offer best clarity and brevity

# Front-page content
Use for what you show on your front page assuming that a standard home page is your front page

# Other contents
Use for other pages like 'About us' 'Contact us' 'FAQ' and you can link these from the menu

greggles’s picture

For most users "Article ~= Story". If we had both Story and Article on a site I think it would drastically increase confusion.

I don't think "page" is a great word, but I can't think of anything better.

I'm -1 on the idea of changing away from page until we get something better.

kaakuu’s picture

So, when you have Blog enabled also, this finally looks like

# Front-page content
Use for what you show on your front page assuming that a standard home page is your front page

#Blog entry
Use for multi-user blogs. Every user gets a personal blog, in which each new post is a Blog entry.

# Other contents
Use for other pages like 'About us' 'Contact us' 'FAQ' and you can link these from the menu

Shai’s picture

@kaaku notes that the description texts of the content-types are "very clearly written." That's part of the problem... There is nothing "core" about those texts. They are really sample texts, and very easily changed. But because they ship with core and there is no other sample content in core, one thinks those texts have some authority or that they mean something... when in fact, they are just samples.

There is absolutely no functional difference between an "article" and a "page." Drupal's install.php sets workflow and byline defaults differently for the two. That's it.

In order to reach out to newbies, Drupal core has created a sparse information architecture to get people up and going quickly. But I think that this desire to make things easy has had the unintended consequence of making things hard.

I think it would actually be easier for newbies if Drupal core shipped with no content-types pre-configured. I think that the process of creating the first content-type on the site would have a lasting value in helping that person understand Drupal and build the site the way they want.

@kaaku. I believe it would be a terrible idea to have a content-type called "front-page." Front page can be set a gazillion other ways including the "promote to front" toggle and via Views according to any variables you want to set. This is about "type" not presentation.

@kaaku, I do think that "Other contents" is along the lines of what I've been thinking.

Shai

kaakuu’s picture

When I was a fresh newbie I found Drupal's structure of contents most helpful - it helped to instantly create front page matters, set per-user blogs, create wiki, and create a forum.

"no content-types pre-configured" is very problematic. It fails to directly provide "Add content" (Add content link or button) and folks keep on wondering what to do. Users are familiar with filling a box with title and some content and that's it. Not everybody is developer-minded or learner-minded. If they are at all confused by the Story/Article/Page enigma this phase passes off soon. Any other phase takes longer or can take longer or may be impassable pushing them to other less complex CMSes.

Any thing in Drupal whether it is a content of any content-type or whether it is Views (but is Views exactly for newbies we are discussing?) or OG or whatever can be promoted to front page, CAN BE, but that is not the default behavior. The default behavior is Article is promoted to front page, Page is not.

"Front-page content" (not "front-page") stands for that "workflow and byline defaults" and the accompanying text "Use for what you show on your front page assuming that a standard home page is your front page" details or explains that a little bit more.

Is there any typical common use of Article other than front page? Obviously one can create Articles and disable front page promotion so that they appear as Pages but at first go telling or explaining this is complex.

So may be then, based on what you find terrible, things should be

# Article
Use articles for content like news, announcements, top stories. By default these appear on front page.

#Blog entry
Use for multi-user blogs. Every user gets a personal blog, in which each new post is a Blog entry.

# Other contents
Use for other pages like 'About us' 'Contact us' 'FAQ' and you can link these from the menu

mikey_p’s picture

Bottom line is this: All the descriptions of what makes a page a page, and an article an article are subjective to the settings for each content type. Also these types may be freely deleted and changed and replaced. Therefore:

What this issue is really about is that some users don't understand what creating a new Page on their website means. To me this falls under the duty of the descriptive text to clarify the role of these different content types.

I would also give renaming 'page' a huge -1. You just aren't going to find something that fits better. Extending the descriptive text is a different story.

Crell’s picture

I few weeks ago, I was talking to one of our interns and trying to explain a particular issue. I realized that I used the word "page" three times in one sentence to refer to three different things. (I believe page node type, page.tpl.php, and the $page flag in node rendering.) I've been meaning to submit an issue about it but keep forgetting, so thanks Shai for beating me to it! :-)

At Palantir, our old CMS used the term "General page" for what Drupal calls "Page" nodes. I'm torn on eliminating the "page" word entirely. For a first time user it does give some indication of where to get started, even if it's slightly misleading.

Perhaps "General content"?

webchick’s picture

We did indeed see in usability testing that the word "Page" confuses people. Primarily, it confuses people who are used to a "Page" being something in a tool like Dreamweaver or Front Page: everything from the top-left corner of the browser window to the bottom-right. A "web page" on the Internet is inclusive of the header, sidebars, etc. Not just the page content.

That being said, I am honestly not sure what we would change it to. "Static content" would be technically accurate, but a tremendous WTF for both new and existing users. WordPress also uses "Page" just as Drupal does, so there is support out there for our current wording.

Primarily, this seems to be an education issue with people not grasping the difference between a dynanic content management system that runs chunks of content through a site-wide template and a static HTML site where each individual page is independently its own thing. Our best bet is likely to try and make this distinction more clear to newbies, although I'm not sure the description of the Page type is the best place to do it.

kaakuu’s picture

As I said I as newbie, or even those whom I know, as newbies had NO problem with "Page" or even "Story". The killing of Story is very sad to me , and if Page is killed it will be sadder.

I am not sure about Static content, because apart from English, in several other languages it will mean something that cannot be ever edited again, while in practice the use cases of Page like About us or FAQ can change or often change.

I will rather go for
# Other contents
Use for other pages like 'About us' 'Contact us' 'FAQ' and you can link these from the menu

and yes, the descriptive text is important because that is an important guide here, and precisely that can represent the most use of the Page like creating an About us and linking from menu.

The other way for going is describing everything as Page and assigning it numbers BUT with fuller descriptive texts - this is a cold laboratory way. Like

--------------------
# Page Type 1
Use for articles for content like news, announcements, top stories. By default these appear on front page.

# Page Type 2
Use for multi-user blogs. Every user gets a personal blog, in which each new post is a Blog entry.

# Page Type 3
Use for other pages like 'About us' 'Contact us' 'FAQ' and you can link these from your site's menu

You can also create your own Page type by creating your own field labels, fields etc [here] or by clicking the tab at top right. You can create front-page publish option for any of these you wish.

------------------

Oh Yes, WP using it means many users are already familiar with the word Page and what it does. And Drupal can stay well with Page.

espirates’s picture

I think both "page" and "story" are pretty clear and easy to follow. Page is for everything that is not a story and other types ie general info page, etc. A story is something that you tell or share, like a blog post, article, etc.

I vote for leaving them as they are :)

kaakuu’s picture

@espirates - Info page is also something that is shared :) BUT Story has been already been changed to the much colder word Article in Drupal 7 dev version. Is there any vote ?! If so I also do the same as you - leave them as they are :)

webchick’s picture

We have real-world testing data from various university usability studies to show that story was confusing and article was not. I don't see a reason to reverse this decision, no.

kaakuu’s picture

ok :)
No problem. I was just saying what espirates said - "vote"
While other CMSes do have excellent vote options from front page for such issues and which actually brings MORE real world data than university studies in certain cases, Drupal keeps out vote which I believe have been kept out for good and sufficient reasons.

Article is already in Drupal 7, and I do not think anything much is coming out of this issue, so I said "If there is any vote" :)

Shai’s picture

Title: Change Name of "Page" Content-Type to Something Else » Change Name of "Page" Content-Type to "Info"

I'm now proposing specifically that "Page" be changed to "Info." I'm changing the issue title to reflect that.

What Crell said in #11 is very important. This problem isn't only affecting site admins and editors. It is also making it harder to learn Drupal for programmers. We've got page.tpl.php and $page. Just to add to that list, the Drupal api documentation makes lots of references to "page requests" and "page callbacks."

I agree with @webchick that people struggle to learn how a db driven CMS works after having coded static pages. I'm simply suggesting that a Drupal distro that comes pre-installed with a content-type called "Page" makes that learning curve harder. Let's not choose to ignore the evidence we have from usability studies that shows that users found the term "Page" confusing.

We shouldn't be asking the question, "What is the best name of a content-type for 'About' pages and their ilk?" Rather, we should be asking the question, "What is the least bad alternative to replace 'Page' because we know it is confusing?"

Here is a short list of places in the Drupal UI where the word "page" means a web page and not a content-type page:

  1. Block admin at: admin/structure/block "This page provides a drag-and-drop interface for assigning a block to a region..."
  2. Individual block configuration at: admin/structure/block/configure/(module controlling block)/(block name)>, Fieldset called: "Page specific visibility settings"
  3. 404 Error "Page not found"
  4. Profile module at admin/settings/profile/add/ in the visibility section there are two references to "profile page" and the intro section says, "This page..."
  5. At admin/settings/performance there is a field set called "Page cache" and a setting called "Page caching mode"
  6. The statistics modules at admin/settings/statistics "Log each page access."

I think "Info" would be a huge improvement over page given the conceptual name-space problem.

In terms of a patch, which I would be happy to roll, it looks like the changes are at line 130 and 132 in drupal/profile/default.profile. But then there are a bunch of places in the various test modules I think would also need to be changed. I don't think this would be an upgrade issue at all since sites having the page content type would just keep them. Upgrading doesn't touch the .profile files.

kaakuu’s picture

Title: Change Name of "Page" Content-Type to "General Content" » Change Name of "Page" Content-Type to "Info"

Some facts -

Two large CMSes - WP and Elgg ,and perhaps many others, already use the word Page.

When I post a front page Story (Article) that acts as announcement (and indeed Announcement posts are made in the home page often) I am serving some vital Info ( Information, the way you mean it) . So this is in conflict - what do I use Story (Article) or Page/Info to serve a piece of info/information ?

Edited - to remove the wrong message by me on Info

kaakuu’s picture

Some facts -

Two large CMSes - WP and Elgg ,and perhaps many others, already use the word Page.

When I post a front page Story (Article) that acts as announcement (and indeed Announcement posts are made in the home page often) I am serving some vital Info ( Information, the way you mean it) . So this is in conflict - what do I use Story (Article) or Page/Info to serve a piece of info/information ?

nicholosophy’s picture

I think Page can be confusing for some (it wasn't for me personally) but what is better? I don't believe that using 'Info' will help at all.

@kaakuu I think trying to use the notion that Info means informal is off the mark. Info is in common use as an abbreviation for Information. I don't believe that this should be an argument against using Info.

Why I don't believe that Info is the right solution is that you could put many things on this page that isn't considered Information.

I think in the end that despite the confusion around Page, there isn't a better alternative that I can see. Better documentation of the content types for new users could be a way forward.

If there was to be no content types as default, what about a walk through for first time users as part of the install process? They could select from "predefined content types" and get what exists now (perhaps with additional explanation of the content types) or "create their own". It might be a good option for developers who usually delete the default types to start afresh. When creating their first new content type, extended help could be provided.

Shai’s picture

@Nicholas Perkins,

The current D7 (I highly recommend for anyone to install it and see what is coming... LOTS and LOTS of great stuff!) offers two choices at the beginning, one "expert" install which doesn't create any content-types for you, and a second which is along the lines of how it works now with D6, two content-types.

Another way out of this problem would be to not include the Page content-type at all, just have article. But also have poll and forum modules turned on by default so that newbies could see that multiple content-types exist. And you also see the reason for multiple content types because those content-types actually have different fields whereas article and page have the same fields.

Why is "Page" needed at all? People can create an "About" page using the "article" content-type. Just uncheck "promote to front" and add it to your primary links? Voila. Suggesting to people via that Page content-type description-text that you need a separate content-type to get an "About" kind of page is just not true. That just messes with people's learning curve.

Shai

kaakuu’s picture

Why is "Page" needed at all? People can create an "About" page using the "article" content-type. Just uncheck "promote to front" and add it to your primary links? Voila

It sort of messes the site's structure, when I list contents of content-type Story or make a search on the type Story - this "page" will also show up, which is not what I may want.

Shai’s picture

@kaakuu,

It sort of messes the site's structure, when I list contents of content-type Story or make a search on the type Story - this "page" will also show up, which is not what I may want.

Then create a new content-type and call it "Page."

kaakuu’s picture

Which is why that is already done for me by the default install :)

It is good that I have to take minimal steps in those directions and devote MORE time to get real contents and users for my site.

Shai’s picture

@kaakuu,

It takes about two minutes to create a new content-type that doesn't have any extra fields.

It's always easier to learn as opposed to unlearn. Confusion really gets in the way of learning.

Have you created a custom template for your "Page" content type? You do that by copying "node.tpl.php" and renaming it, "node-page.tpl.php" all the while not touching page.tpl.php. That took me a lot of frustrating hours to sort out. And I even conceptually understood then how page.tpl.php had nothing to do with Page node types... but I still got confused.

Shai

webchick’s picture

I agree that the goal of the default installation profile is to remove steps that the majority of site builders are going to do, not add to them.

Shai, you say:

Why is "Page" needed at all? People can create an "About" page using the "article" content-type. Just uncheck "promote to front" and add it to your primary links? Voila.

Sure, for you and I it's "just" a matter of unchecking promote to front page and adding it to the primary links. But try watching a new user attempt to figure this out on their own.

a) They have no idea what menus are.
b) Let alone the distinction between primary and secondary links.
c) They don't know that nodes have publishing options.
d) Even if they do manage to figure that much out, they have no idea what "promote to front page" actually means.
e) They will not be able to recover from the situation of their About Us content showing up in the same list as their "Hot deals this weekend" content.
f) They will also have no idea how to shut off the annoying "Submitted by admin on 2009/06/13" from the top which makes no sense on static content.
g) So their first experience with Drupal will be wandering aimlessly around the admin panel for 20-30 minutes being frustrated.

It used to be that Story and Page were the same. Over the past few releases we've been steadily making them different, to conform to what we've widely seen are user expectations for how these two types of content should differ from one another. I don't see a compelling reason to reverse this direction, especially given that competing CMSes offer the distinction between "Blog" or "Article" and "Page" out of the box, so users will expect to see this here.

Shai’s picture

@webchick,

You write,

Sure, for you and I it's "just" a matter of unchecking promote to front page and adding it to the primary links. But try watching a new user attempt to figure this out on their own.

Why not include a sample "About Page" with "Promote to front "turned off" and it attached to the primary menu. On that page would be an explanation of "submitted by" and menus. And in bold print, "Click on the 'Edit' tab to change/delete this information" and also a link to the same info on a docs page so they don't need to worry about deleting it.

With the current system, people learn by inference that "submitted by" and "promote to front" are attributes of content that are related to the "article" content-type. NOT. It is an inference that will need to be unlearned later. Unlearning is harder than learning.

a) They have no idea what menus are.

Having a "Page" content type will not help them with that. They create their about page and it disappears. With the vast improvements already committed in D7 -- wow, its' great -- that is less likely to happen because of the new "Find Content" link. But in any case, the pre-configured "Page" content-type doesn't help one bit in getting it onto a menu. It just helps in having it not show up on the front page.

f) They will also have no idea how to shut off the annoying "Submitted by admin on 2009/06/13" from the top which makes no sense on static content.

That setting is now at admin/structure/node-type/(content-type name). Soooo much better. People will find this and understand this a lot easier now.

But this is all a digression. @webchick's response was to a side-point I made in response to @kaakuu in which I proposed having no "Page" content type. That proposal would have to go in another issue. This issue is about changing "Page" to "Info". Repeating from #18: We shouldn't be asking the question, "What is the best name of a content-type for 'About' pages and their ilk?" Rather, we should be asking the question, "What is the least bad alternative to replace 'Page' because we know it is confusing?"

Crell's concerns from #11 and reiterated and elaborated by me in #18 have not been addressed.

Shai

webchick’s picture

Re: most of #28:

I've no problem expanding the documentation for new users. But why are you advocating un-doing progress we've made in matching end-user expectations with the difference between a 'Page' and a 'Story/Article' instead of advocating that Drupal ships with a page like http://support.wordpress.com/post-vs-page/ which explains the difference, as well as the fact that these options are configurable? Seems like that way we could help people with the learning curve and not break the mental model of people coming to Drupal from other CMSes, and not create a bunch of annoying extra work for people who already know what they're doing (and the difference between Page/Article) and just want to use the Default profile as a starting point for their site.

We shouldn't be asking the question, "What is the best name of a content-type for 'About' pages and their ilk?" Rather, we should be asking the question, "What is the least bad alternative to replace 'Page' because we know it is confusing?"

Crell's concerns from #11 and reiterated and elaborated by me in #18 have not been addressed.

AFAIK, every reply has addressed this. They've all basically said, "Yep, it sure is confusing, but 'Page' is what users expect to see based on their experiences with other CMS platforms, so I do not support changing it."

Crell's #11 is dealing with themer-related WTFs. I've no argument that the distinction between page.tpl.php, node-page.tpl.php and $page are confusing. I have a big argument with the presumption that the way to solve this is to introduce a WTF to every end-user of Drupal because the theme system is confusing. No, thanks.

#18 gives a good run-down of many places where we could try and come up with a new word to mean "this entire thing in my browser window" (maybe 'screen' or 'web page'?). However, that doesn't support changing the content type 'Page' (a word instantly recognizable to every end user) to 'Info' (an ambiguous word that doesn't remotely describe what it does and the default configuration differences therein).

Shai’s picture

Re: #29

I've no problem expanding the documentation for new users. But why are you advocating un-doing progress we've made in matching end-user expectations with the difference between a 'Page' and a 'Story/Article' instead of advocating that Drupal ships with a page like http://support.wordpress.com/post-vs-page/ which explains the difference, as well as the fact that these options are configurable?

How much of "matching end-user expectations" is dependent on a label for a content-type? We could have a similar help page called, "Article vs. General Content" (replace "general content" with "info" or whatever we came up with to replace "page"). To the degree that there is a set of user expectations based on WordPress precedent, I would say those expectations are based on functionality and not on labels.

Just because Wordpress uses it doesn't mean it's not confusing, even on Wordpress sites.

Also, what significantly separates Drupal from Wordpress is Drupal's flexibility. The learning curve around understanding dynamic web sites is very important. Understanding what a "node" is may not be first on my agenda when having someone start with Drupal. But having a node-type called "Page" will only set people back from understanding what a node is, which will eventually be helpful to any site admin.

introduce a WTF to every end-user of Drupal

Changing "Page" to "General Content" in going to introduce a WTF to every end-user? You mean a worse WTF than the WTF we already have with "Page" based on evidence from usability testing. And this new WTF from a differently labeled "Page" content-type is because they just came from Wordpress and expect a "Page?"

The description text for page is, "Use pages for your static content, such as an 'About us' page." Ouch. The word "static" should not be in there, because that word comes up when trying to explain the difference between static and dynamic web sites. A "Page" node is just as dynamic as any other node in a Drupal site. Again, I'm not advocating trying to teach how Drupal and relational databases work to someone just trying to install Drupal. But I don't want to give them bad information that will need to be unlearned later.

As for the list I created of places in the UI that use word "page" to mean web page and not page content-type. I would absolutely NOT want to change those. They are easily understandable and use the common sense of the word web-page. Even though page.tpl.php is not something that beginners see, I think the fact that it was named such communicates that even geek programmers share what the common meaning of the word "web page".

Shai’s picture

Title: Change Name of "Page" Content-Type to "Info" » Change Name of "Page" Content-Type to "Info" or "General Content"
kaakuu’s picture

is less likely to happen because of the new "Find Content" link.

Find content link was always there, perhaps in a more simpler "Content" link. It may have helped university test users but the bar is a toggle bar which will already be disabled by Admin menu users, which is among the top 3 or 4 highest usage as well as prepacked with vastly advertised distros like Acquia.
Moreover users like me who find it obtrusive because at standard 800 resolutions it occupies almost 1/3rd of screen real estate with other chrome with lots of useless empty and depressing grey space just toggle it off :)

What can help here is either a longish name or the accompanying descriptive text as suggested above like making the descriptive text
"Make pages like About us, Contact, FAQ and you link these from the menu"

What can help here is a little more intelligent status message after the Page is created - instead of 'your page has been created', it should be like "your page has been created, if you have not already linked it to the menu, you may want to do so, so that your users can actually see the page."

Change Name of "Page" Content-Type to "Info" or "General Content"

Stories are general content, specially all the stories that are not sticky. Typical "about us" page is other content or sometimes even special content.

Wordpress or Elgg (its a giant too) or e107 or others using Page does not mean we have to use it but the fact that its usage is somewhat confirmed and accepted in the net.

laura s’s picture

"Page" is simply confusing, because it uses a word that already has common usage in referring to websites: page in a more general sense, having a distinct URL.

In common parlance, "page" is used to refer to what in Drupal we might call a view, a panel, a profile, an admin screen. Using the word "page" to describe a pre-existing node type just asks for confusion.

Call it "static". Call it "example". Call it "node". Since nodes is nodes is nodes, I'm not sure what to call it, but I do believe that calling it something that gets confused with something else is a mistake.

And this is Drupal, where past practice has not prevented improvements and sometimes radical changes.

+1 to changing it. Big time!

kaakuu’s picture

@Laura

Call it "static". Call it "example". Call it "node".

Compare this two

Please visit our "About us" page
Please visit the "Contact us" page
Please visit the FAQ page

and

Please visit our About us "static"/ "example"/ "node".
Please visit the "Contact us" "static"/ "example"/ "node".
Please visit the FAQ "static"/ "example"/ "node".

You see Page is in common use and Page in Drupal actually helps to create that type of Page.

laura s’s picture

@kaakuu Your examples are precisely why I feel the "page" node type should be renamed or dropped.

"Contact us" page is actually not a node, it's a contact form generated by a different module. "Page" node does not create this.

"FAQ" page is not a node, it's a view or a custom display page generated by the FAQ module. "Page" node does not normally create this.

"About us" page might be a node, but doesn't have to be.

You see, calling all the different URLs on a website "page" is something everybody does. Having a "page" node type misleads, and adds to confusion. Just look at how this thread is going. People are having to qualify what they mean by "page" all the time. It's confusing as hell! @crell is right on this.

kaakuu’s picture

@Laura

Your examples are precisely why I feel the "page" node type should be renamed or dropped.

I beg to disagree. Precisely I feel for those examples and other reasons as well Page may continue if not some terms like "Other content"

"Contact us" page is actually not a node, it's a contact form generated by a different module. "Page" node does not create this.

When you use a form it can be a form. In many cases its a Page in html that writes the brick-and-mortar address of a company, names and emails of contact departments, list of relevant phone numbers etc, perhaps the link to the contact form and sometimes even a link to chat.

"FAQ" page is not a node, it's a view or a custom display page generated by the FAQ module. "Page" node does not normally create this.

A small to medium sized FAQ or FAQ on a brochure site is a Page. I have never used FAQ module, which in any case is used by a meager 7000 or so users, considering FAQ is there almost on all sites

"About us" page might be a node, but doesn't have to be.

Nothing has to be this or that BUT it usually is :)

Is there any concrete suggestion from you like #7 or #13 ?

If you suggest at this stage you should suggest something concrete, the exact word you want, and then it can be debated if that word serves the purpose better than the word 'Page'

laura s’s picture

Of all the suggestions, I think "static" is the best. Either that, or drop "page" and don't replace it at all.

Keeping "page" just gives people a false sense of what "page" does because it conflates the node concept with the already much more prevalent concept that a web "page" is anything you find at a unique URL.

Crell’s picture

I will again reiterate my recommendation for "General content". It has no built-in implication of what it is or does other than "blob of stuff", which is precisely what "page" nodes are currently. It really cannot be confused with any other part of Drupal. And it introduces the concept of "content", which we hammer people with throughout the rest of the admin.

Perhaps we should ask Leisa to weigh in here, seeing as how she does this professionally and most of the people in this thread do not. :-)

laura s’s picture

I could go with @crell's suggestion of "general content" for the reasons he states.

Shai’s picture

Title: Change Name of "Page" Content-Type to "Info" or "General Content" » Change Name of "Page" Content-Type to "General Content"

Changing Issue title to be in synch with opinions voiced in #38 and #39.

kaakuu’s picture

This issue has changed title so many times which perhaps show how unstable all these new names can be.
Can there be anything more professional than hugely successful CMSes like WP, Elgg, e107 etc? I think their usage of Page is proof-of-concept that this works. They must have passed through intense external or internal debates to reach this usage. "General content" on final thought does not appeal to me as general content can apply to all the stories in a site OR textual content as in contrast to media content.
Page in Drupal allows to add selective sections like About us or Contact etc which are rather not general but components with those distinct heads (About, Contact etc) and contents of highly selective purposes.

ScoutBaker’s picture

@#19

kaakuu stated:

Info is actually short form of Informal - http://dictionary.reference.com/browse/info
while About us or Contact us are formal data

Just as a clarification, the term "info" does not stand for "informal." As stated on the page that they referenced, it is an informal word meaning "information."

kaakuu’s picture

@scoutbaker - I apologize. That has been removed by me. Since that will be no longer in this thread there is no point in further bringing that up :)

Shai’s picture

Title: Change Name of "Page" Content-Type to "Info" » Change Name of "Page" Content-Type to "General Content"

@kaakuu, During the week of July 26, 96,000 + web sites pinged drupal.org and reported they have the Views module for Drupal 6 turned on. Do WP, Elgg or e107 have anything close to Views? Views numbers are all the more amazing given how hard it can be to learn Views, especially for non-programmers. People are motivated to learn Views because it gives them so much control over their web site.

In the Drupal environment, where many people have come to Drupal because of Views, we have to be especially careful not to confuse people; the learning curve is already steep. Therefore WP, Elgg's and e107 use of the word "Page" is of minimal relevance to this conversation. And I fully agree with what @laura s said in #35.

Both sides in this conversation have raised the issue of how docs, help texts etc. can be of help. And however this sorts out in the end, that is true. The help texts needed if we were to change the name of the "Page" pre-configured content-type to "General Content", will be about providing excellent starter recipes for typical sites. On the other hand, the help texts we must provide should "Page" stay as a pre-configured content-type will require disambiguation (page in situation "a" means "x" but in situation "b" it means "y") in addition to references to static/dynamic etc. I think the second scenario is harder. I'd rather help people get over a hump then clean up a semantic mess.

Shai

kaakuu’s picture

I have already said why I do not favor "General Content" and why/how "Page" is in very common usage in the CMS world.

There is no "Views" in the other CMS, though WP is reaching something like that via Pods but that is a "probably" and out of scope for this discussion. What I believe about Views and Page is that it is

# Views is more intuitive than one having to go to create a content-type just after install
# the user has already learned some Drupal ways when he is into Views
# the user wants to setup some webpages instantly after install and he may not be in a need or mood to learn
# views is often managed by more of developer-built sites or those who have financial support to hire
# default Drupal should be very easy for the masses like install, click, add content AND not a teaching room at the outset
# I even believe that default Drupal should start the add content page with 5 types - Story, Blog, Book, Forum, Page - making lesser options or being "lightweight" is counter-intuitive and counter productive here BUT this again are my personal beliefs and out of scope of this thread

I am fine with "Page" OR "Other contents" but possibly not with General content

Leaving out the names BUT keeping a good description and asking to fill up the name at the time when you visit the Add Content page (as opposed to the time of install) can be another option of course :) with suggestion of possible names in the descriptive texts.

kaakuu’s picture

96,000 + web sites pinged drupal.org and reported they have the Views module for Drupal 6 turned on

On an average there are 170,000 plus Drupal users very month. How many have complained about "Page"?
Test beds can sometimes create notoriously non issues out of issues. Your experience with users or test users who came to learn Drupal can vary widely with mine.

NancyDru’s picture

-1 for me. I already have a major site that will have trouble because it has a content type named "article." The only saving grace is that Aquia is probably going to have to fix it.

There is some historical "baggage" that should remain, and the content type names is one of them.

webchick’s picture

"-1 for me. I already have a major site that will have trouble because it has a content type named "article." The only saving grace is that Aquia is probably going to have to fix it."

Nothing changes on update. This change is only for new Drupal sites who choose the "Default" installation profile during installation. Same as the change discussed here. There is absolutely nothing that stops anyone from using the "Expert" profile and not making a "Page" type at all.

Shai’s picture

@NancyDru,

I don't think you'll have any problem with your site that has a content-type named "article." The installation of dafault.profile (where the pre-installed content-types live) get's activated by running install.php. With an update, you run update.php. install.php never is run on an update.

As for, "There is some historical 'baggage' that should remain, and the content type names is one of them." I don't know whether to laugh or cry at that one. Maybe I'll do both. :)

Shai

Crell’s picture

"What other CMSes do" is, honestly, not a big concern to me. OK, WP uses the word "page". Do they use it in the same way we do? Do we know if they have usability issues with their usage of it? Does the question even apply given that WP and Drupal are extremely different systems with different workflows they're optimized for, despite the trade press always talking about Joomla, WP, and Drupal as if they were identical open source offerings?

No, we don't know that. What we do know is that we have both experimental and anecdotal evidence that "Page" is a poor name for a node type in Drupal as it is far too overloaded a word in Drupal. To me, the only question is what we change it to, not whether or not we change it. For that, to be honest, I will defer to someone who actually has training or experience in usability over the "will of the mob", as the mob tends to suck at usability decisions. (I actually do have training in usability, but haven't worked in that field in long enough that I am admittedly rusty.)

kaakuu’s picture

over the "will of the mob", as the mob tends to suck at usability decisions.

LOL. Are we just mob and nothing else? Do we suck at usability decisions? I wonder and so does some real contributors. "Mob" gave you the CMS, "mob" uses the CMS either freely or helps drupal firms make money, and the "mob" has so far no significant complaint on the term "Page"

This thread is going nowhere and I think I have made some good points, which in summary are

# Keep Page as it is, or
# Make it "Other contents" with proper descriptive text & status message to add it to menu, or
# Keep the name blank with a good blob of text and suggestive names, asking to fill it up at the time of visit to Add content page, with show/hide descriptive text options

I will now stick out of this addictive issue or similar addictive but non-productive-for-me issues and will be more interested in what I can get for my ultimate end users whose participation make or break a site.

Peace and cheers!

webchick’s picture

Honestly, what we probably need are some "real world" user tests with Drupal and several different options, and then try and derive from that what caused the least / most confusion among a wide range of users, but especially including those who had never used Drupal before. My hunch based on my participation in other tests of this nature is that people coming from other CMSes (and people who get frustrated with the limitations of WP and come to Drupal in search of something more flexible is a non-trivial amount of our audience) will not understand what to do if they can't scan for the word "Page". My other hunch is that "General content" or "Info" will not make this initial confusion problem any better, and will only raise even more questions. But the bottom line is we won't know without real-world testing, unless Leisa & co. have a quick "Oh, we already have data for this and it's blah" answer.

However, since this ultimately whatever we decide here is at best just going to change a string, and there are literally hundreds of other issues in the queue that involve more far-reaching changes and therefore need to be resolved before 9/1 or not at all for D7, it'd be lovely to see even 1/1000th of the ferocious energy going into this issue on some of the other, more pressing issues in the queue. This issue can always be revisited after code freeze, and maybe some of the folks strongly advocating for a change can head up some crowd-sourced usability testing.

Cliff’s picture

Amen to that, webchick!

Today is the first time I have done more than skim each message of this thread as it popped into my "In" box. Having just now read this thread from top to bottom, I am quite amazed to note how strongly people insist that "Page" be changed to one thing or another — not that we look for a better term for "Page," but that this specific word be chosen.

"Let us vote!" some have said. "We use this all the time; we should be the ones to decide!"

No, not really. I still have a ton to learn about setting up and managing the back end of Web sites, but one field I do know fairly well is usability testing. I'm not the world's foremost expert in usability testing, but it is a large part of what I do in my day job. And the first lesson usability testing offers each of us who dabbles in site design is that performance trumps preference every time.

A vote will tell us what all the people who participate in that poll prefer. Every usability expert has a plethora of tales of sites gone wrong because they were designed according to the users' stated preferences. In other words, when people who use a program or Web site a lot say, "It would be better if it were designed this way," they are usually wrong. Not only does it turn out to be worse for other users, but frequently — perhaps usually — it turns out to be worse for the people who suggested that specific "improvement" themselves.

I admire the approach the Drupal community has taken in moving from D5 and D6 to D7:

  1. Through valid usability testing, find out whether the current setup works.
  2. To the extent that is doesn't work, identify the problems and their source.
  3. Prioritize those problems according to their impact on usability and the likelihood of solving them.
  4. Identify potential solutions to those problems.
  5. Finally, test those proposed solutions just as the original setup was tested.
  6. If a proposed solution proves its worth, implement it. Otherwise, continue identifying potential solutions and testing them until something truly better than the original setup is found.

Admittedly, this process has not been followed exclusively, but it seems to me that the community has been remarkably consistent in following it. Together, the third and sixth steps of this process have made the work towards D7 a purposeful march towards excellence rather than a helter-skelter scamper through the wilderness.

And webchick is right that we should follow the same process here.

Is "Page" a terrible label? Probably. It still gives me a "WTF?" moment.

Would "Info" or "General Content" be better? Not likely. In this short discussion, we have seen that each gives at least a few of us "WTF?" moments of their own.

But, more to the point, there is not one bit of information obtained through valid usability testing that says either of those terms — or anything else, for that matter — would work better than "Page." And each word proposed needs to pass that testing not only in English but also when translated into literally a world of other languages, to ensure that no developers will be more confused by the new term than they are now.

Which might leave us to conclude that "Page" is to Drupal what Winston Churchill said democracy is to government: the worst possible option, except for all the others.

Let's not change it until we know that our change will actually be an improvement.

laura s’s picture

Honestly, what we probably need are some "real world" user tests with Drupal and several different options, and then try and derive from that what caused the least / most confusion among a wide range of users, but especially including those who had never used Drupal before.
-webchick

My usability anecdata on this comes from dealing with clients for whom Drupal is new, plus working with Drupal-expert colleagues in discussing site architecture.

"This page is a view. This page is a panel. This page is a profile. This page is a page."

Huh?

We end up stumbling over the words. The words get in the way of the concepts we're trying to communicate. "Yeah, but you didn't come up with the better solution!" Okay, but maybe we're asking the wrong question.

Nodes are nodes and not fish. When talking about pages we constantly and repeatedly have to clarify what kind of "page" we're talking about. Why? Because Drupal, which has in many ways reinvented how websites are architected, clings to a 1994 concept of a web "page" and applies it to a node type, which is not by any definition a web page. That node type is still a node, still can be embedded into views, panels, blocks and so on. And can contain views and fields and even other pages (as in page nodes). A node simply is not a page, even though it can pretend to be.

If we really need a page object (as in an object with a unique URI that is the only way it can be consumed) then that's a separate issue.

skessler’s picture

@webchick and others -

I have been using Drupal for some time now and I still find the fact that it is called a page very confusing. Page implies (to me and I think others) the whole unit. I think that something like Page Content or General Content would work very well. Many of us probably change the names of content types to fit our specific implementations but we need to find something that is intuitive out of the box. General Content or Just Content would get my vote.

webchick’s picture

I'm not really interested at all in votes, I'm interested in data.

Set up a Drupal site with two content types: {whatever} and Article. Tell someone who's never used Drupal before to create an "About us" page. Video tape their screen/voice while they're doing it (with their consent), take notes on what happened, and put it on YouTube so the rest of us can see.

NancyDru’s picture

@webchick: Is this how "Article" was chosen? I personally was shocked and confused by it the first time I saw it.

The fact is that there really is no difference between "Article" and "Page" (or whatever you choose), so is it even really necessary to have two content types by default? What would happen to your test if there was no choice to have to make? I'm going to hazard a guess that the new Drupal user would actually be much happier not making the choice at all. And the experienced Drupal user is probably converting a site and may be really confused that all his/her "Story" content is now called "Article" and "Page" content is something else -- unless the old types are not converted (I haven't tried an upgrade yet).

webchick’s picture

@webchick: Is this how "Article" was chosen? I personally was shocked and confused by it the first time I saw it.

This change had consensus by basically everyone in the issue, and was further backed up by formal usability studies, yes.

The fact is that there really is no difference between "Article" and "Page" (or whatever you choose), so is it even really necessary to have two content types by default?

There are differences. Page doesn't promote to front page, has authoring info turned off, and doesn't allow comments. If #351249: Finer control over the Parent Menu select box gets in with a 'required' checkbox, I would love to apply that to Page as well (and remove menu selection from article). Every site I've ever built has needed a content type with exactly these features, so I see no particular reason to give people more work to do out of the box.

NancyDru’s picture

My experiences are different, but that's fine. Perhaps, then the key to a name is in the settings choices (as there is still no difference in the content type itself).

Crell’s picture

NancyDru: Existing sites will be unaffected by Story->Article and by anything that happens as a result of this issue as well. This is just the default install profile, nothing else.

Cliff: As both you and webchick have noted, while we seem to have a data that "Page" is a poor name we don't have good data on what a better name would be. Since you work in web usability, would you be able to put together some testing to determine a better name? I'd rather not leave this until the next time we have a big sponsored usability lab available, as there will be legitimately larger fish to fry at that point.

Shai’s picture

Mindful of @webchick's #52 in which she said this discussion is a distraction from working on code improvements in advance of code freeze of 9/1, let me be explicit that I"m not asking for her or anyone else to respond to this now. @webchick defined this as a "string" issue which could be addressed after code freeze. So the urgency on this issue is low.

An analogy came to me today regarding this whole issue. I think there is a lot of talking past each other here and I'm hoping this analogy will help people understand what I'm saying.

Pharmaceutical drugs are supposed to:

  1. help to solve a medical problem
  2. do as little harm as possible

The "Page" content-type is like a drug that is helping with the following problem: "How can we jump start users to create a web site quickly that has content that won't show up on the home page, won't have "submitted by" and won't have comments turned on by default?"

The "conceptual name-space collision" that has been addressed here in the original issue and comments #11, #18, #33, and #54, and others is analogous to an "adverse effect." Adverse effects have nothing to do with how well the drug works to perform its stated function. They speak of unintended consequences that are by-products of their use.

Vioxx was not taken off the market because it wasn't a good pain killer. Vioxx was pulled because of the potential risk it was causing users; risks that that had nothing to do with its effectiveness as a painkiller.

It seems like the proposals we've heard so far for user-testing in advance of replacing "Page" suggest that the goal of the test would be to find a string that best cures the condition: getting a web site up quickly for a newbie to Drupal. And if no string is found, then stick with "Page." If that were indeed the approach that user-testers would take, it would be faulty because it doesn't take into account "side-effects." You'd need to have a way to score side-effects.

Here is an example of an oversimplified scoring chart for a system that took into account side affects:

"Page"
Solves problem of helping new user getting "about" pages launched and working (on a scale of 0 - 5, 5 best): 5
Adverse effects (on a scale of 0 to minus 5, 0 having the fewest adverse effects): minus 4
Total score for "Page": 1

"General Content"
Solves problem of helping new user getting "about" pages launched and working (on a scale of 0 - 5, 5 best): 3
Adverse effects (on a scale of 0 to minus 5, 0 having the fewest adverse effects): minus 1
Total score for "General Content": 2

Obviously these are made-up results based on my hunches :). But it illustrates the point that I don't believe that our replacement for "Page" needs to do a better job at solving the problem that "Page" is trying to solve. After you net the adverse effects it needs to do better.

And how about the confounding problem that averse affects are often felt outside of core. For example, the Views module uses "Page" in a way that is a conceptual name-space clash with the content-type "Page." 200,000 sites phone home to drupal.org with Views installed. Can user testing take into account adverse effects that occur in conjunction with Views?

In short:evaluation of a solution to a problem must include the unintended consequences associated with the solution.

Shai

NancyDru’s picture

And then there is the problem for converted sites that already have "story" and "page" that will continue to exist and confuse people... Oh, well...

silverwing’s picture

I'll say I'm perfectly happy with the word "page" as used by Drupal. It's used in many other platforms and is, in my mind, perfectly understandable. (And the help text in the 'node/add' page works well.)

Other terms just seem clumsy. "Static Content" "General Page" "General Content" "Sergeant Node" - I can see more problems coming from a name change than without. Do they really mean anything differently than "page" to most users?

Since the first release that "Page" was part of Drupal, has it been a showstopper for anyone? Do people look at it and say "Oh, a page. I don't know what to do. Guess I'll have to try Joomla."

It really does seem like much ado about nothing.

As for changing "story" to "article" that I can agree with.

uNeedStuff’s picture

Most of my clients are not at all computer literate. I have one who continued to add pages to WP instead of a blog post. You think taxonomy is hard to explain, I still can't get her to understand the difference between tag & category. This isn't someone who's going to come to Drupal anytime soon. However I finally was able to explain the page versus post, by saying "a page doesn't change, and nothing drops on top of it."

I guess the point I'm trying to make is the initial word is for someone who doesn't want to read a ton of information, they just want their site up. Is it really going to confuse someone who understands that everything is a node and what you call it doesn't matter? Or someone who wants to understand how it actually works? I don't think so. Anyone to already understands, it matters not at all, anyone who wants to understand can find the information.

Someone with no understanding of how Drupal works doesn't understand that there is actually no page in existence that it's built when it's accessed. They think it's a "page" sitting somewhere. Here are some of the terms I've heard:
Yeah I just want a standard page
a regular page
you know just a page

This doesn't mean they won't learn about it, but they don't want to learn 1st. They just want to put something together and feel like they have accomplished something.

They also barely have an understanding of the word content.

For the person that wants to understand, there is plenty of information out there. I think the word page works for someone who doesn't understand the structure.

I believe the majority of people I work with would understand:
Use pages for your static content, such as an 'About us' page.

I however would remove the words time-specific from:
Use articles for time-specific content like news, press releases or blog posts.

WTF is time-specific ;-)

NancyDru’s picture

Yes, I was much like that when I first came to Drupal with a static HTML site to convert. "Page" made more sense to me than "story" at the time. It wasn't until I finally figured out a simple taxonomy that "story" made any sense to me. But I still didn't want anything being promoted to the front "page" because that was originally supposed to be static; as a matter of fact, on that site, other than some blocks, that page is still largely static, although it is now a "story" and there are two other little "story" pieces (also pretty much static) that have joined it.

Cliff’s picture

@Crell (#60): Doubtful that I would have time and resources to orchestrate that test, but I'll mull it over. Who knows what I might think of?

@laura s (#54): I hope you'll take the next-to-last paragraph of that post and work the gist of it into Drupal docs wherever it is that we explain what a "node" is. That would help so many newbies — and seasoned vets — get it. (In fact, I think I just did. Now could you come up with something for "taxonomy"?)

Oh, and I just now finally learned what "My issues" was all about, so I'll be following discussion less haphazardly now.

Shai’s picture

Code freeze is upon us... last chance for UI changes; here's a final effort at moving this one. Even if "Page" is a better name for a pre-configured content-type than "General Content," does its value overcome the other problems it causes in regard to theming and working with Views?

I make three arguments below targeted at three different beginning users; person setting up a site for the first time, person just learning Views, person delving into code of the theme layer for first time.

  1. Person setting up site. A "Page" is one of two pre-installed "content-types" but the word "Page" is a type of presentation delivery, not a type of content. "Article," "Forum post", "Blog post", Poll" all describe a type of content. In addition, "Page" is a confusing choice because it's close to "web page." But in this context, it doesn't mean that.
  2. Person just learning Views. 111,000 of the 189,000 D6 sites "phoning home" to d.o. have Views installed. Newbies quickly learn that Views is a critical module in building rich Drupal web sites. Views is powerful, but it is also hard to learn.

    Views uses the word "Page" in its UI as one of four built-in "displays": block, page, feed, attachment. In views, the term "Page" connotes a "web page." In fact, when you choose "Page" as a display type, you'll get error messages until you define a path. A new user of Drupal will be confused by Views use of "Page" after having seen "Page" as a core content-type.

  3. Person delving into the code of the theme layer for the first time. In order to customize Drupal , you must jump into the theme layer. The template suggestion system is clever and powerful, but confusing. Success or profound frustration at this moment can determine whether a person will stick with Drupal. In this initial foray, she will face page.tpl.php. In node.tpl.php you find the $page variable. A likely use-case is to theme by content-type, and many themes provide template suggestions for that. So to theme a Page content-type you can end up with page-page.tpl.php and node-page.tpl.php.

    If you can understand the structure, you get to bend Drupal to your will and make theming Drupal easier than Wordpress, according to John Albin (Zen guy) in a recent Lullabot podcast. But often the experience is totally frustrating. At this critical time in someone's "Drupal life," the Page content-type is making something that is hard, harder.

I will cede #1. Most of the arguments against this proposal have been arguing that point. So what I challenge the people who are against this proposal to take up is the following question: When thinking of Drupal as a whole, why are the advantages of keeping "Page" over "General Content" as a pre-configured content-type more important than removing its disadvantages. Only comparing "Page" vs. "General Content" does not do this proposal justice.

suydam’s picture

I think you can kill "Page" because "Story" makes sense (it's a real content-type) and if page wasn't an option, Story (or "article") would solve the problem.

Want to build a page that shows textual content... that's an article (which is a better title than "Story" in my opinion).

Want to build a page that is a view of diverse node types? That's a page-view. It could include stories, no problem.

Then you'd have story.tpl.php view-something-or-other.tpl.php and page.tpl.php (page.tpl.php denoting the DISPLAY VEHICLE as you mentioned).

To me it's a no-brainer. If we were starting over from scratch, "Page" would not likely be even discussed as a content-type along side story, event, etc.

That's my $0.02!

nicksanta’s picture

-1

This is a silly idea - webchick is absolutely right way up there about gradually building expectations of what each of the core content types are.

@Shai, the only thing that needs to change is people's concept about what a 'page' is from a CMS point of view.

yoroy’s picture

It's not silly. At all. It's about removing ambiguous choices that get in the way and cause mental friction, especially for new users, especially on first time use. These unnecessary choices are exactly what makes Drupal hard to use for newbies. In that sense this is not a trivial issue, either.

…the only thing that needs to change is people's concept about what a 'page' is from a CMS point of view.

Right, how is changing the mental model of what a page is in a CMS 'the only thing'? "You know, it's called a page, we know you think about it as a page, but it's not really a page, you only have to think about it differently than you do now, but we'll still call it a page"? How is keeping a content type named 'Page' any help in this? Why make this a problem of the user? Instead we should remove the cause for confusion.

The problem is not in wether it's useful to have a general content type 'page' by default in itself. The problem is that new people don't know which to choose when confronted with the article vs. page choice. Where the page choice has the unfortunate consequence of not being promoted to the front page, effectively making it disappear. The 'find content' link in the toolbar will help with this, but it's still weird behaviour. We should avoid that pitfall.

Even if new users are looking for 'page', it's just to ambiguous a term in a Drupal context. Do we really think that if somebody can't find 'Page', she won't dare to create an 'Article'? It'll be much much easier to choose between 'article' and 'picture' for example.

We're argueing back and forth about the name. There is no good name for this general content container. "General content" is silly and more an expression of Drupal not wanting to make assumptions on usage than a helpful label. Hopelesly politically correct I'd say, only 1 step away from you know, "stuff".

I would still suggest to remove it and maybe, maybe suggest somewhere in the interface text that this might be a first useful content *type* you might want to create yourself.

Shai’s picture

@nickurbits, you wrote,

…the only thing that needs to change [strong added] is people's concept about what a 'page' is from a CMS point of view.

You haven't addressed the disambiguation issue. If "Page" as content-type is the CMS approach, and therefore a conventional understanding of "Page" is wrong from a CMS point-of-view, then Drupal has a lot of cleanup up to do. Up at #18 I partially documented D7's use of the term "page" in its conventional sense including "page cache," the block visibility UI and others. That list does not include contrib.

@nickurbits, are you in favor of changes elsewhere in the D7 UI to rid "page" as a term used in its conventional sense? Or are you fine with the burden of disambiguation being left up to each user?

Crell’s picture

Issue tags: +DrupalWTF

From a Drupal CMS point of view, a "page" is about four different things. Regardless of what mental model someone comes into Drupal with, that's a WTF.

webchick’s picture

the page choice has the unfortunate consequence of not being promoted to the front page, effectively making it disappear.

This is OT from the topic of this thread, but I think an ideal solution for this wtf problem (which exists regardless of whether we ship with page or not) is adding a "Required" checkbox to the menu settings at admin/structure/types/manage/XXX. Then it would not be possible to create content that gets totally lost.

uNeedStuff’s picture

I feel that having Article & Page for someone completely new to working in a CMS covers the two type of content that a simple user will want. Whether they are using them correctly or not isn't the issue. The issue imho is will they be able to create what they want to. If they don't understand what a CMS actual is, but know they want something that changes, and adapts, they start from a place of wanting static and non-static. Even if a page content type isn't really static, it will give them the "feel" and actual presentation easily of a static page. I haven't heard a single suggestion that would mean that to someone who doesn't understand that there isn't anything static period. However the feel of that is there with the two default content types. Neither article, story, or general content would sound like what someone wants if they want to create a about page, home page, services page, bio page. Someone new sees these as static, and will not think that they are an article or story, and would have a questioning look on their face on general content. General content? Isn't that what my articles are? General, or do I us that when I don't want to add a tag or category and they are just general information I want to share?

However as page is part of all of those examples of what most people look for to create. I believe they would be less likely to not find what they need, leaving the page a page and not have it promoted.

Shai’s picture

@WebWeaver64,

I'm ceding the issue you are discussing, point 1 on my comment #67; I'll agree with you.

But can you argue that that point is more important than the other two I addressed? One becomes a novice over and over when working with Drupal. So there are novices at many different levels. I don't think that the new folks turning on a Drupal site for the first time and creating their first nodes are more important than the the folks who are trying to tackle Views or theming for the first time.

Also, I think it is easier for a new person to get help overcoming an inferior out-of-the-box content type named "General Content" than it is to get hand-holding with Views and with those dark materials inside your theme folder.

[OT: I just rewrote this response, removing all mentions of the term "newbie." All of a sudden it sounded derogatory to me.]

Shai

Shai’s picture

Two things relevant to this discussion that popped into my ears and eyeballs in the last 24-hours:

  1. On the recent Lullabot Podcast: Drupal Screwups and Common Mistakes, Jeff Eaton specifically mentions "Page as content-type" as a Drupal WTF that seriously confuses people.
  2. On the Drupal development list serve yesterday, someone reported that he had concluded that some SQL errors he was seeing were caused by the fact that his web host doesn't support the Views module. The guy was very frustrated. Turns out, it was a mis-communication because the hosting tech thought he was asking about MySQL 5's "Views" functionality. The Drupal Views module does not employ MySQL Views functionality at all. His SQL errors are being caused by something else. I raise this here to give a concrete example of how real and problematic name-space collisions can be, even when they exist outside of code. The Drupal/Views MySQL/Views example is one where nothing can be done but education; neither MySQL nor @merlinofchaos can change the name. But the "Page" content type is a name space collision that we can fix. And if we do, we'll help reduce the amount of headbanging in the world. And that's a good thing!!

Shai

eaton’s picture

Uhoh! Looks like a shout-out. ;-)

Although I'm loathe to appeal to WordPress for our decisions, in this case it may be instructive. They use the words 'post' and 'page' in the WordPress UI to distinguish the different content types.

We face a complicated decision for a couple of reasons:

  • Creating a node -- regardless of its content type -- does result in a new page being created on the site with the url www.example.com/node/123, or whatever the node ID is.
  • Having a particular type of node whose only job is to cause the creation of a standalone page with some static content does make sense -- that's a useful feature regardless of what we call it.
  • The confusion (at least as I see it) comes from the fact that creating a 'page' in this way, whether you do it with a Page Node in Drupal or a Page Post in WordPress, comes from the fact that you can't "hijack" the entire page, blowing away the navigation and headers and so on by pasting an entire HTML document into the node's body.

That final part is really a doosie, and it cuts to the heart of the "CMS/Dynamic webapp" question. There aren't really any true static "pages" in something like WordPress, Joomla!, or Drupal. If we rename 'page' we need to keep in mind that while the terminology is confusing, by creating a page node they are creating a page -- but it's a page that automatically gets extras like navigation, headers, and sidebars from the theme without any extra intervention.

I tend towards the idea that better explanation of the term 'page' can help, but unless I'm mistaken D7's "basic stripped down" profile already comes without a page content type -- or is it that it ONLY includes the page content type? I'll need to double check.

webchick’s picture

The "minimal" profile comes with /no/ content types. Or much of anything, really. :) It's the "framework" version of Drupal.

The "default" profile has both "Page" and "Article" (formerly "Story"). As of yesterday, Page and Article are even more different in the default profile, in that Article now has both a "Tags" and "Image" field, where Page just has Title and Body.

webchick’s picture

Oh. Something else that's been discussed earlier is adding a dedicated "Image" content type. Unfortunately, I don't see how we can do that until Views (or equivalent) gets into core. That would allow us to ship with a photo gallery, which is the primary use for an image type. In core right now, all you'd get is a front page with mixed images and articles, which is pretty meh.

Shai’s picture

@eaton Yah, I was pleased to shout out a Drupal rockstar like you, but I didn't get the "+1" I was hoping for ;-).

First up, I'd love it if you could address the two other points that I've raised. I've pointed out that the issue is not just about "Page" vs "General Content" or whatever else we would choose. It's also about the consequences we face if we don't do anything. I specifically mention learning Views and learning theming as two areas where "Page" as content-type casts a long shadow. See my comment #67.

If we rename 'page' we need to keep in mind that while the terminology is confusing, by creating a page node they are creating a page -- but it's a page that automatically gets extras like navigation, headers, and sidebars from the theme without any extra intervention.

That sounds like an argument +1-ing these efforts to dump "Page" as a pre-configured content type. You point out that indeed, a new page IS created every time someone clicks "save" on a node/add form. But that is true for ANY content-type. We shouldn't build expectations that things are going to be any different based on what the string is we use to name a content-type. It almost sounds like you are arguing for a different kind of functionality altogether which could indeed take over a whole page. [Maybe we could make it possible to suppress block visibility from inside the node/add form.] However, I don't think the issue of trying to teach new people to Drupal about what a CMS is can be handled at all by naming and configuring a content-type that ships pre-configured.

To answer your question about D7. The stripped-down version comes with zero content types. If you go to node/add you get a message, "You need to create a content type before you can add content" with a link to the add content-types page. A new person to Drupal will not use the stripped down install. She'll use the normal install. And then when she dives in to learn Views and then theming, the "Page" content type will be swimming through her brain cells, laughing at every moment of confusion and wasted time that it will cause her.

Shai

uNeedStuff’s picture

As for the Views page issue, imho the use of the term page is the same as the use of a content type page. You have a specific place to go (url) to see what it is you are creating. Whether you're creating it with Views, or by creating the content yourself (content type page), you need to give it a url to see it. I don't think it's confusing at all, and personally that's how I understood it when I've used Views. I'm creating content that will be seen as a page even though it doesn't actually exist as a "page." To see a page you need to create a url for it, applies in both these instances.

I'm creating content with the content type Page
I want people to see this content as a (page)

I'm creating content with Views
I want people to see this content as a (page)

Again, once people are familiar with the concept, and creating new content types, they are understanding the concept and what something is called all becomes mute. This comes back to the purpose of my suggestion being for "what are people looking for when they don't understand the basic structure of drupal, and just want to create something."

As for the theme, I don't understand any of that, nor have I ever attempted to change anything, so before even giving an answer I'd have to know what page.tpl.php is and how it's used. If page.page.tpl.php means what a page would look like if it was a page content type or if page.article.tpl.php is for what a page would look like if it was an article content type, then I think again this fits in with the page content type and how many people new to a CMS understand what a "page" is. Having said that, maybe this is the one to change if it doesn't apply to a "page" and what a "page" would look like when it's displayed. I also feel anyone who is going to make changes to any of these files would 1st try to understand what the parts and pieces mean and look for that information. This would not be the person who we are talking about in the above examples. Anyone who understands php and how it applies in themeing understands that we're not dealing with static content, so have a basic understanding of a page isn't really a page i.e. static html e.g. about page, bio, services, etc.

If it needs to be different then the other page's then call it General Page. ;-)

Shai’s picture

@WebWeaver64

Whether you're creating it with Views, or by creating the content yourself (content type page), you need to give it a url to see it.

That is true for Views, but not for creating Page content-type or any other node. Drupal sequentially assigns a node id # which then becomes part of the path of the node, example.com/node/29. But that's a fine point.

For me disambiguation is of the highest value. It's at the nexus of all communication. Views Page display, the Page content-type and page.tpl.php are very different animals. The fact they don't seem to stymie you in your Drupal learning curve is great. But the fact that they mean different things using the same letters, means that they require disambiguation. That's a burden.

I just noticed that the name of Lisa Reichelt's web site is: http://www.disambiguity.com/. She's the user experience designer who has been working with Mark Boulton on Drupal user experience.

Shai

kaakuu’s picture

@shai

There is still option that an intermediary can change the word 'page' for her clients. But in English as in many other languages there are plenty of words with double or triple meanings. May be the correction should start from there ? There are more learners of the language than of Drupal.
To me this appears as a geeky concern, apart from 'some test' users or 'some other' users this has not been a real issue as appears from the issue lists. There are much more serious and much more needed concerns, imho. Many of the users are accustomed with 'page', so changing this breaks 'things' for them, many of future users, according to you, will be confused, so not changing will break things for them. Its a 50-50 situation? There are 100-0 situations which needs tackling first, imho.

Continue the debate, I am sorry for the interruption but could not help as this dead issue keeps popping up in the tracker with no means to delete it.

Shai’s picture

@kaakuu,

Continue the debate, I am sorry for the interruption but could not help as this dead issue keeps popping up in the tracker with no means to delete it.

Set up a rule or filter (same thing, different email programs call it differently) in your email program that will grab emails with subject: 'Change Name of "Page" Content-Type to "General Content"' and send them directly to the trash.

"This appears to be a geeky concern." Yah, geeks are people too ;-). But more to the point, Drupal benefits greatly from people feeling empowered enough to discover their inner geek. I came to Drupal as a rabbi with primitive coding skills. Now I'm a professional Drupal developer. I'd like to make life better for people who are willing to do stuff they have never done before on the geeky side.

"Many of the users are accustomed with 'page', so changing this breaks 'things' for them." That's not true for established sites upgraded to D7. The Page content-type will NOT disappear. The code we are talking about changing is only fired upon installing a new Drupal site. Nothing will change for existing users. As for someone accustomed to firing up new Drupal sites, yah, they would not see a pre-configured "Page" content-type. They'll also notice that "Story" is now "Article." D7 is going to be different in many ways. I don't think changing the name of Page will be a big deal for people with experience creating new Drupal sites.

uNeedStuff’s picture

@shai I'm not saying this removes all the confusion. Or solves the disambiguation of the word. To me that is another animal completely. The people I've worked with don't care how something works, or what is making it work. They don't want me to explain it. They just want me to tell them how to do X. What happens to make X works doesn't matter to them. They are focused on their business, don't want to have to learn about something else, they want a website where they can put up their information, and don't want to spend time to understand how it works. I've had a hard time learning how to build in Drupal, I do like to understand, there is no way I would use D6 for any of my current clients and it's why I use WP for them. I'm hoping that D7 is different (and from what I've seen it is). For me and my clients Page works the best of all the suggestions I've seen. I'm not saying it is the best, or it works in other ways for other end users. However the other end users (not someone who doesn't care to learn and/or someone very new to web design/development) the disambiguation of the word page can be explained in documentation, or just further learning of how things work. Better documentation for Drupal is also crucial imho.

I believe page gives a good starting point, and the ability to add other content types solves the other issue where they say well I don't want an article really or a page, then moves to creating something new to use. My experience/suggestions are coming from people who want a blog type content with something that also allows them to have "static" pages. I would love to use Drupal because they also could use the ability to grow beyond both those content types; they hold conferences, events, radio programs, etc. and I know that drupal has the ability to add all of those pieces into a much more full and complex site.

All of this is why I vote no, don't change the name :)

David_Rothstein’s picture

Reading through this issue, it seems like complete agreement is going to be difficult. However, a possible compromise might be to keep "Page" but put an adjective in front...? That way, the word "page" is still there for users who are scanning for it, but it is also distinguishable from the 18 million other uses of the word "page" throughout Drupal.

Looking through this issue for specific suggestions that were already made along those lines (as well as adding a few new ones), we might have:

  • Anchor page
  • Basic page
  • General page
  • Informational page
  • Page content
  • Simple page
  • Standalone page
  • Static page
  • (something else?)

I think that choosing something like one of those would at least help solve the original problem, and in a way that probably still has a shot at getting into Drupal 7 without the massive amounts of usability testing that a move completely away from "page" would likely require.

Shai’s picture

I'm good with @David_Rothstein's proposed compromise (#86), which @WebWeaver64 hinted at as well in #81.

Of David's suggestions, I like: General page (previously also suggested by @WebWeaver64), Informational page, and Simple page.

[OT: On a related but different matter, I'm proposing that for the the "Page" content-type (or whatever we end up calling it) we pre-install the body field as a "long text" type field instead of "long text with summary." The possibility to do this is totally new with D7 since the body field is now a field like any other field. The "long text with summary" (what is currently installed) includes the confusing "edit summary/ hide summary" javascript UI which facilitates controlling what goes in the teaser vs. what gets displayed in full node view. It can be powerful, but very confusing. This page type is less likely to show up on a list and so the UI is even more confusing. You can still have the same functionality by adding a summary field. Anyway, didn't mean to go on this long, but I recommend followers of this issue to check out that issue: http://drupal.org/node/626546]

Shai

lilou’s picture

Or "Standard page".

yoroy’s picture

'Basic page' is good.

Shai’s picture

I'll add "Basic page" to the ones I like (General page, Informational page, Simple page).

@lilou, I don't like "Standard page" so much because the word "standard" can sometimes refer to a specific set of criteria. A good example of that is "Web standards."

Shai

uNeedStuff’s picture

- Anchor page
+ Basic page
+ General page
- Informational page
+ Page content
+ Simple page
- Standalone page
- Static page
- Standard page

+ I like, - I don't ;-)
Not sure how we would vote on this. I'm currently leaning toward the terms Basic or Simple page for two reasons. It has the word page in it, and the words basic & simple indicates it's not fancy and might lead someone to ask the question "well what else could I do", which would then bring them back to drupal.org to learn more about adding content types, yet for someone who didn't want to learn more they have what they can use to create a simple or basic page.

Shai’s picture

@WebWeaver64,

Not sure how we would vote on this.

Alas, open source is not a democracy... maybe it's democratic. But in the end, Dries and Angie will decide and that will be that.

One thing that makes Dries such a great leader of a project like this is that he really trusts "the community" and wants participation and input. But sometimes a decision simply needs to be made and it's Dries who can do that.

Shai

webchick’s picture

I could definitely live with "Basic page," if that's the consensus (which it appears is slowly materializing). It keeps the "keyword" people will be searching for, while differentiating it from the "browser window page" itself.

If we couple this change with keeping "page" as the machine-readable type name, while we don't address Crell's concerns about page.tpl.php vs. node-page.tpl.php confusion, we also don't invalidate 10 years' worth of documentation. It feels pretty late in the cycle to be doing that (though something to perhaps explore in D8), so I'd go with just a change of the human-readable name.

yoroy’s picture

Status: Active » Needs review
FileSize
814 bytes

Is changing it in default.install enough then?

Status: Needs review » Needs work

The last submitted patch failed testing.

Shai’s picture

Status: Needs work » Needs review

@webchick,

If we couple this change with keeping "page" as the machine-readable type name, while we don't address Crell's concerns about page.tpl.php vs. node-page.tpl.php confusion, we also don't invalidate 10 years' worth of documentation.

I'm having a hard time finding any of the documentation @webchick is referring to. I've looked searching via Google and d.o. search. Of folks following this thread, are you able to find such pages? @webchick has raised a concern; if it's valid, then I think leaving the machine name as "page" for now is a good part of the compromise. I'm just not sure there is much documentation that would be invalidated by changing the machine name as well.

Also, given that @webchick seems to be referring to d.o. handbook pages which are not part of Drupal core, I'm not understanding how "late in the cycle" plays in to this. I would commit to updating handbook pages in a timely way and in such a way that allows for people still using previous versions.

I'm very pleased with the emerging consensus that has come out of this discussion.

Shai

yoroy’s picture

Title: Change Name of "Page" Content-Type to "General Content" » Change Name of "Page" Content-Type to "Basic Page"
Status: Needs review » Needs work

Status.

Shai: I'm assuming Webchick refers to documentation in the form of all the Drupal books, blog posts etc.

Shai’s picture

@yoroy,

Is she referring to documentation that makes specific reference to the machine name "page" in which "page" as an absolute term makes a difference? I notice that the new article content-type which replaced story uses "article" as the machine name as in: node/add/article.

I think that either "basic" or "basicpage" would be good for the machine name.

It seems like most documentation relevant to that would be about disambiguating page from it's other meanings, and so a user using an outmoded doc piece would see that something had been fixed.

Also, Drupal major releases have so many changes including API changes that I think most people want to consult with newer documentation anyway.

Thanks for changing the issue title name.

Shai

webchick’s picture

We are past the point of API changes in D7, so changing the machine-readable name is a no-go. Can revisit in D8.

I'm not sure why the test bot is choking on this patch, but I suspect that there may be tests that are explicitly checking for a link called "Page" or similar.

David_Rothstein’s picture

Status: Needs work » Needs review
FileSize
17.79 KB

Yeah, it is pretty unfortunate when you can't change a simple string without breaking 27 tests :( Anyway, this should get most (hopefully all) of them.

Regarding the machine-readable name, it doesn't seem to me like changing that would really constitute an API change? It's added by an install profile, so if there's a module out there that is trying to rely on its existence, they've got serious problems. (Changing it could legitimately break a module's tests, I guess, just like it's now breaking core's, but that seems relatively low risk.)

webchick’s picture

Yeah, it is the test breakage I'm concerned with. Last I checked, contrib tests were making heavy use of drupalPost('node/add/page', ...) and the like.

If the consensus is that we go with 'basic_page' for the machine readable name, though, I guess we could bloat the size of this patch by another 500K fixing all of the places in core that make this assumption. :P I'm just not sure that page.tpl.php vs. node-basic-page.tpl.php is going to make things sufficiently less confusing to justify the pain.

webchick’s picture

Oh. And themers have started porting too, so node-page.tpl.php -> node-basic-page.tpl.php screws them as well.

Shai’s picture

Re: tests. The purpose of the tests is to serve the code, not the other way around.

(Having said that I I don't want to minimize any pain that would be involved. I went from being a non-profit manager to a Drupal developer because I liked getting stuff done and there was a shortage of people who actually do stuff as opposed to telling other people to do stuff. So I really understand that while coding to serve the tests is not ideal, in certain situations it may dictate choices.)

Re: themers. I just searched cvs.drupal.org and I couldn't find one file named node-page.tpl.php. Themers assume Page nodes will use the generic node.tpl.php that they build. It's when people start customizing themes that they create node-page.tpl.php. Those customizations, it turns out, have never been checked in to CVS as part of a contrib theme.

Re: choosing a machine name. Should the machine-name change move forward, I would advocate that the name we choose not include a hypen. Good choices might be 'basicpage' or 'basic'. The template suggestion system relies heavily on the use of hyphens and therefore introducing a hyphen that is not a part of the template suggestion syntax adds confusion.

Shai

BrightBold’s picture

Just wanted to weigh in as another person who feels that "Page" is confusing, for all the reasons mentioned above. I found this thread as I was writing up user documentation on how to create content for a site, and kept stumbling over how to differentiate "Page" the content type from "page" of the site. +1 for disambiguity!

(And as an aside, +1 on article too. When I started using Drupal one of the biggest stumbling blocks for me was what the heck a "story" was and why you would want any content that wasn't a "page" (because I was thinking "web page" not "Drupal content-type page.") Only once I started site building and theming did the difference become clear. So in my mind changing these terms will reduce the learning curve for new folks, both end users and designer/developers.)

Crell’s picture

"Basic page" works for me. For the machine name, I see webchick's point about not changing the machine name; I suppose I can go either way there. If it changes, though, I would echo Shai's comment that it should not contain a hyphen or underscore. Those are already highly confusing, and I try to avoid them entirely in node machine names. So it's either "Basic page / page" or "Basic page / basicpage".

The latter would be more complete, but I see webchick's point about how large that patch could be at this point as so many things assumes the presence of a node type named "page" for testing code or defaults or such. (Except for one of my modules that presumes the presence of "story" for defaults, which even my sites don't tend to have. Figures. :-) I'll have to change that anyway for D7, but it's an easy change so I'm not particularly worried.)

catch’s picture

Basic page works for me too.

I'd tend towards leaving the machine name as is - we have 'Blog entry' / blog already - it can be useful to have views which use the content type machine name as an argument ('page' looks a lot nicer for that than 'basic-page'), updating all those tests will be a pain and potentially break a lot of pending test patches.

David_Rothstein’s picture

FileSize
17.79 KB

The patch in #103 still applies, but didn't come back green for some reason. I'm reuploading it again for testing.

It sounds like there's fairly wide agreement here. If the testbot says it good, can we mark it RTBC?

catch’s picture

Status: Needs review » Reviewed & tested by the community

Yep, test hunks make me sad, but that's not for this issue.

yoroy’s picture

Lets do this

kaakuu’s picture

If there is a Basic Page what shall be called Advanced Page ? I mean advanced users or even new users may look for advanced page and find none!

Shai’s picture

re: RTBC, I was still holding out some hope for a change in the machine name...

It's important to note re: the pain involved in updating tests: this points to limitations and/or flaws in the testing system. Just as standardized tests for school children cause teachers to "teach to the test" regardless of educational value, this would be a case where a problem that is easy to fix in the code is put off because of the demands of the tests. Those demands are real. It may be a good choice of priorities to delay the machine name change because of the amount of work it would cause to fix the tests. But I do think this does serve as a good example of one of the downsides of testing.

In short... if Webchick and Dries think this isn't the time to fix the tests regarding the machine name change... then I also think it is RTBC.

If Webchick and Dries support fixing this problem more fully, then we need to hear a strategy for how to go about fixing the tests and how we can help.

Shai

catch’s picture

I like the simpler machine name - 'Forum topic' has a machine name of 'forum', this seems fine to me, easier to type, better for views arguments etc.

Shai’s picture

@catch see @Crell with #11 above and elsewhere explaining how a machine name of "page" causes confusion for template suggestions since page.tpl.php is a key player. I think the consensus we came to was that changing the machine name would "finish" the job but may not be worth it because of test re-writing.

As for your concerns that the machine name be simple; how about"basic" (again, with the caveat about whether changing the machine name and the disambiguation benefits merit the extra work).

Shai

catch’s picture

The template suggestions issue is interesting, but that's a lot further up the learning curve than creating a page then trying to add views or forms to it (as we saw in usability testing) - so I'd rather we got 'Basic page' in - since that doesn't create new WTFs, even if there's possible enhancements to be made in D8 to remove remaining ones left in, given it's already December 1st here.

Shai’s picture

@catch wrote... "but that's a lot further up the learning curve." It's a real mistake to focus all our usability improvements on one point of the learning curve. I would surmise that a person's first foray into tinkering with template files is a major right-of-passage in their Drupal life. I'm sure we lose a lot of people right there. Even though these folks might be a minority of people, the folks who do make it past this trial-by-fire are likely to be contributors to the community.

Making a custom Drupal site... getting it to bend to your will but in a way that your site is still upgradable and easily passed to another developer.... At that point it fully makes sense to not be using Wordpress! You are now leveraging Drupal and getting the goodness. Having "page" as a machine name to be used as part of template suggestions turns the rite-of-passage into a hazing ritual :)

As I've said, because of the testing problem it might make sense to put the machine name change off until D8. But it's also a missed opportunity, in my opinion, to ease the learning curve significantly for beginners to move up to the next level.

Shai

catch’s picture

I agree with that, but it's a developer/themer experience issue as opposed to UX, and we're about six weeks past DX freeze at this point. Changing the machine name also means potentially breaking any contrib module tests which rely on the default profile (quite likely given how many core tests do), so while it's crap that we've had simpletest in core for a year and still have dozens of tests making bad assumptions, I don't think it's worth the potential pain to change the machine name at this point.

webchick’s picture

Boy, December was a rough month. :P

I'm pretty sure this needs a re-roll. But let's go ahead and try this change this release. (the name change, not the machine-name change)

I don't think it's going to ultimately address the root confusion about the word "page", but it at least gives us one simple way to help clarify meaning: "No, no. BASIC page, not X page..."

Status: Reviewed & tested by the community » Needs review
Issue tags: -DrupalWTF

Re-test of basicpage-542972-103.patch from comment #110 was requested by webchick.

Status: Needs review » Needs work
Issue tags: +DrupalWTF

The last submitted patch, basicpage-542972-103.patch, failed testing.

Shai’s picture

Status: Needs review » Needs work
FileSize
15.42 KB

Attached is a reroll of #110: Probably the biggest change since #110 was rolled is that "default.install" has been renamed "standard.install. Anyway, it's been a while.

I changed all the "human readable" references to the "Page" content type and replaced them with "Basic page" while leaving the machine name as "page".

Shai

yoroy’s picture

Status: Needs work » Needs review

testbot, please review :)

The last submitted patch, Basic-page-542972-123.patch, failed testing.

Shai’s picture

So it had 413 "Pass" and 1 "Fail" for the following test:

DBLog event was recorded: [delete user] Other dblog.test 251 DBLogTestCase->doUser()

Ideas?

Shai

Status: Needs work » Needs review

Re-test of Basic-page-542972-123.patch from comment #123 was requested by aspilicious.

aspilicious’s picture

Maybe has something to do with this #638496: Random failures in dblog tests ?
I asked for a retest

Shai’s picture

Yeah! It's "passing on all environments" now.

Hmmm, just noticed that Dave's patch was 17.79kb while mine was 15.42kb. Is that a concern? Could I have missed something?

Shai

aspilicious’s picture

These were the files he was chanching
*****************************

Index: modules/filter/filter.test
Index: modules/locale/locale.test
Index: modules/node/node.test
Index: modules/php/php.test
Index: modules/search/search.test
Index: modules/taxonomy/taxonomy.test
Index: modules/translation/translation.test
Index: modules/trigger/trigger.test
Index: modules/upload/upload.test
Index: profiles/default/default.install

These are the files you changed
************************
Index: modules/filter/filter.test
Index: modules/locale/locale.test
Index: modules/node/node.test
Index: modules/php/php.test
Index: modules/statistics/statistics.admin.inc
Index: modules/statistics/statistics.pages.inc
Index: modules/taxonomy/taxonomy.test
Index: modules/translation/translation.test
Index: modules/trigger/trigger.test
Index: profiles/standard/standard.install

Different names, different files, so it can be that the file size is different, im gonna check it manually

aspilicious’s picture

Ok, the only difference I can see is that the

Index: modules/statistics/statistics.admin.inc
Index: modules/statistics/statistics.pages.inc

are added

and that the search tests are missing (if they still exist)

Shai’s picture

@aspilicious,

Wow, thanks for that... just caught a problem...

Those statistics module changes were a mistake, they are not appropriate. The statistics module is using the word "Page" as in "URL" as in hits it is counting, not as in "Page" content type. So I'll undo those and reroll.

As for search, I'll check on that.

Shai

Shai’s picture

FileSize
16.04 KB

Okay, here is the re-roll: It's different from #123:
* removed changes I had added to statistics
* added the changes I missed in search.test

Status: Needs review » Needs work
Issue tags: -DrupalWTF

The last submitted patch, Basic-page-542972-133.patch, failed testing.

Status: Needs work » Needs review
Issue tags: +DrupalWTF

Re-test of Basic-page-542972-133.patch from comment #133 was requested by aspilicious.

aspilicious’s picture

WTF is wrong with the testbot and the language thing. This is the 4th patch I have to retest...

And i'll review your patches again.

aspilicious’s picture

Now everything of #110 is in the patch!
Good job!

Shai’s picture

Okay, patch now passes. I guess we still need a couple of folks to apply it to their own environments? Is that right... And then we would be rtbc...

With all the committing activity it would be nice to get this puppy committed before the patch starts to fail again and require another re-roll...

Shai

webchick’s picture

Status: Needs review » Needs work

This needs a re-roll again (already!). Sorry, but I absolutely had to commit #571654: Revert node titles as fields since that was an major API change.

Status: Needs work » Needs review
Issue tags: -DrupalWTF

Re-test of Basic-page-542972-133.patch from comment #133 was requested by Shai.

Status: Needs review » Needs work
Issue tags: +DrupalWTF

The last submitted patch, Basic-page-542972-133.patch, failed testing.

Shai’s picture

Okay... I'm hoping to re-roll on Sunday before lunch...

Shai’s picture

I'm working on the re-roll now and have a question. In the RDF test, I can't tell whether use of machine name or human-readable name is more appropriate. Can someone help: Here is the code:

  // Insert default user-defined RDF mapping into the database.
  $rdf_mappings = array(
    array(
      'type' => 'node',
      'bundle' => 'page',
      'mapping' => array(
        'rdftype' => array('foaf:Document'),
      ),

Shai

David_Rothstein’s picture

The 'bundle' comes from the Field API, so I believe it should always be the machine-readable name (i.e., 'page').

Thanks for bringing this one home!

Shai’s picture

Status: Needs work » Needs review
FileSize
27.62 KB

Here we go again... :)

Shai’s picture

Folks,

You might note the current patch is significantly bigger than the previous ones... In this last round I made a bunch of changes in documentation sections of the files that hadn't been made previously.

David, thanks. The patch I just submitted leaves the machine name as is on that RDF case.

Here is one that I did change but wasn't totally sure. It's from trigger.test line 43:

      $this->drupalPost('node/add/page', $edit, t('Save'));
      // Make sure the text we want appears.
      $this->assertRaw(t('!post %title has been created.', array('!post' => 'Basic page', '%title' => $edit["title"])), t('Make sure the Basic page has actually been created'));

Status: Needs review » Needs work
Issue tags: -DrupalWTF

The last submitted patch, basic-page-542972-144.patch, failed testing.

Status: Needs work » Needs review

Re-test of basic-page-542972-144.patch from comment #145 was requested by aspilicious.

Status: Needs review » Needs work
Issue tags: +DrupalWTF

The last submitted patch, basic-page-542972-144.patch, failed testing.

Shai’s picture

Status: Needs work » Needs review
FileSize
28.16 KB

That last fail might have been a real fail... here is another try...

Shai’s picture

Can a folk or two look this over so that it can be rtbc'ed... hopefully before the next core patch that breaks it again :)

webchick’s picture

Status: Needs review » Fixed

I went ahead and committed this, since we hit a rare period where test bot was happy. :D If there are additional fixes to be made, go ahead and file follow-up patches here.

Great work on this, folks! I think this is a small but important improvement in helping to reduce first-time user confusion. In D8, we can perhaps explore other options to help reduce themer confusion as well.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.

Itangalo’s picture

Just wanted to say thanks to all the people involved in changing the node type name 'Page' to something else.
With some hundered hours of Drupal training behind me I (too) can testify that there are people finding the term confusing.

Interesting reading in this thread!